Manual Pages for UNIX Operating System command usage for man Tspi_Data_Unseal

Introduction to Library Functions             Tspi_Data_Unseal(3)



NAME
     Tspi_Data_Unseal    -    dencrypt    data    encrypted    by
     Tspi_Data_Seal()  only if it was encrypted on the same plat-
     form and under the current configuration.

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

     TSS_RESULT Tspi_Data_Unseal(TSS_HENCDATA hEncData,              TSS_HKEY hKey,
                                 UINT32       pulUnsealedDataLength, BYTE**   prgbUnsealedData);



DESCRIPTION
     Tspi_Data_Unseal   reveals    data    encrypted    by    the
     Tspi_Data_Seal only if it was encrypted on the same platform
     and the current configuration. This  is  internally  proofed
     and guaranteed by the TPM.

PARAMETERS
  hEncData
     Handle of the data object which contains the sealed data.

  hKey
     Handle to the key object addressing  the  nonmigratable  key
     which is used to decrypt the data.

  pulUnsealedDataLength
     The length (in bytes) of the prgbUnsealedData parameter.

  prgbUnsealedData
     On successful completion  of  the  command,  this  parameter
     points to a buffer containing the plaintext data.

  hPcrComposite
     Handle of the PCR Composite object specifying the PCRs which
     are  part  of  the sealed data blob. Set to NULL, if the en-
     crypted data should only be bound to the system and PCRs are
     not of interest.

RETURN CODES
     Tspi_Data_Unseal returns TSS_SUCCESS on  success,  otherwise
     one of the following values are returned:

     TSS_E_INVALID_HANDLE - Either hEncData or hKey




TSS 1.1              Last change: 2004-05-26                    1






Introduction to Library Functions             Tspi_Data_Unseal(3)



     TSS_E_INTERNAL_ERROR - An error occurred internal


CONFORMING TO
     Tspi_Data_Unseal conforms to  the  Trusted  Computing  Group
     Software Specification version 1.1 Golden

SEE ALSO
     Tspi_Data_Seal(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-26                    2