Manual Pages for UNIX Operating System command usage for man Tspi_Context_LoadKeyByBlob

Introduction to Library Functions   Tspi_Context_LoadKeyByBlob(3)



               TCG Software Stack Developers Reference

NAME
     Tspi_Context_LoadKeyByBlob - load a key into the  TPM  using
     the key's blob.

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

     TSS_RESULT Tspi_Context_LoadKeyByBlob(TSS_HCONTEXT hContext,     TSS_HKEY hUnwrappingKey,
                                           UINT32       ulBlobLength, BYTE*    rgbBlobData,
                                           TSS_HKEY*    phKey);



DESCRIPTION
     Tspi_Context_LoadKeyByBlob creates a key based on the infor-
     mation  gotten  by  the key blob. It then loads the key into
     the TPM, which unwraps the key blob by using the key associ-
     ated with hUnwrappingKey. The key blob addressed by hUnwrap-
     pingKey must have been already loaded  into  the  TPM.  This
     function returns a handle to the created key object.


PARAMETERS
  hContext
     The hContext parameter is the handle of the context object.

  hUnwrappingKey
     The hUnwrappingKey parameter is the handle of the key object
     which should be used to unwrap the key information associat-
     ed with rgbBlobData.

  rgbBlobData
     The rgbBlobData parameter is the wrapped key to load.

  phKey
     The phKey parameter receives the handle of  the  key  object
     representing the loaded key.


RETURN CODES
     Tspi_Context_LoadKeyByBlob returns TSS_SUCCESS  on  success,
     otherwise one of the following values is returned:

     TSS_E_INVALID_HANDLE



TSS 1.1              Last change: 2004-05-25                    1






Introduction to Library Functions   Tspi_Context_LoadKeyByBlob(3)



          hContext 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_Context_LoadKeyByBlob conforms to the Trusted Computing
     Group Software Specification version 1.1 Golden


SEE ALSO
     Tspi_Context_LoadKeyByUUID(3),     Tspi_Policy_SetSecret(3),
     Tspi_GetPolicyObject(3),              Tspi_Key_CreateKey(3),
     Tspi_GetAttribUint32(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