Manual Pages for UNIX Operating System command usage for man Tspi_Key_ConvertMigrationBlob

Introduction to Library Functions
                                 Tspi_Key_ConvertMigrationBlob(3)



               TCG Software Stack Developer's Reference

NAME
     Tspi_Key_ConvertMigrationBlob - create a wrapped key from  a
     migration blob

SYNOPSIS
     #include 
     #include 
     #include 
     #include 
     #include 
     #include 
     #include 

     TSS_RESULT Tspi_Key_ConvertMigrationBlob(TSS_HKEY hKeyToMigrate,         TSS_HKEY hParentKey,
                                              UINT32   ulRandomLength,        BYTE*    rgbRandom,
                                              UINT32   ulMigrationBlobLength, BYTE*    rgbMigrationBlob);



DESCRIPTION
     Tspi_Key_ConvertMigrationBlob takes the migration blob built
     by  Tspi_Key_CreateMigrationBlob  using the migration scheme
     TSS_MS_MIGRATE and creates a normal wrapped key. The result-
     ing  normal wrapped key blob is stored in the instance asso-
     ciated with hKeyToMigrate and may be retrieved from that in-
     stance by Tspi_GetAttribData.


PARAMETERS
  hKeyToMigrate
     The handle of the key object to convert.

  hParentKey
     Handle to the parent key related to  the  key  addressed  by
     hKeyToMigrate.

  ulRandomLength
     Length of random data provided at the parameter rgbRandom.

  rgbRandom
     Random data as returned together with the migration blob  by
     the method Tspi_Key_CreateMigrationBlob.

  ulMigrationBlobLength
     Length of the migration blob data provided at the  parameter
     rgbMigrationBlob.

  rgbMigrationBlob
     Migration blob data  as  returned  by  a  previously  called



TSS 1.1              Last change: 2004-05-25                    1






Introduction to Library Functions
                                 Tspi_Key_ConvertMigrationBlob(3)



     method Tspi_Key_CreateMigrationBlob.


RETURN CODES
     Tspi_Key_ConvertMigrationBlob returns  TSS_SUCCESS  on  suc-
     cess, otherwise one of the following values is returned:

     TSS_E_INVALID_HANDLE
          hKeyToMigrate or hParentKey is not a valid handle.


     TSS_E_INTERNAL_ERROR
          An internal SW error has been detected.


     TSS_E_BAD_PARAMETER
          One or more parameters is bad.


CONFORMING TO
     Tspi_Key_ConvertMigrationBlob conforms to the  Trusted  Com-
     puting Group Software Specification version 1.1 Golden


SEE ALSO
     Tspi_Key_LoadKey(3),                  Tspi_Key_UnloadKey(3),
     Tspi_Key_CertifyKey(3), Tspi_Key_CreateMigrationBlob(3).


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     __________________________________________________
    |   ATTRIBUTE TYPE   |       ATTRIBUTE VALUE      |
    |____________________|_____________________________|_
    | Availability       |  library/security/trousers |
    |____________________|_____________________________|_
    | Interface Stability|  Uncommitted               |
    |____________________|____________________________|

NOTES
     Source for trousers is available  at  http://opensolaris.org
     and at http://sourceforge.net/projects/trousers.  Documenta-
     tion   is   available    at    file:///usr/share/man,    and
     http://sourceforge.net/projects/trousers.








TSS 1.1              Last change: 2004-05-25                    2






Introduction to Library Functions
                                 Tspi_Key_ConvertMigrationBlob(3)






















































TSS 1.1              Last change: 2004-05-25                    3