Manual Pages for UNIX Operating System command usage for man Tspi_Data_Unbind

Introduction to Library Functions             Tspi_Data_Unbind(3)



               TCG Software Stack Developer's Reference

NAME
     Tspi_Data_Unbind - Decrypts data that has been  bound  to  a
     key

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

     TSS_RESULT Tspi_Data_Unbind(TSS_HENCDATA hEncData,             TSS_HKEY hEncKey,
                                 UINT32*      pulUnboundDataLength, BYTE**   prgbUnboundData);



DESCRIPTION
     Tspi_Data_Unbind decrypts the  encrypted  data  blob  expor-
     tedfrom the data object used in Tspi_Data_Bind. The encrypt-
     ed data blob must be imported to  the  object  addressed  by
     Tspi_SetAttribData before calling this method.


PARAMETERS
  hEncData
     The handle of the data object which contains  the  encrypted
     data.

  hEncKey
     Handle to the key object addressing the private key which is
     used to decrypt the data.

  pulDataLength
     Receives the length of the data  at  the  parameter  prgbUn-
     boundData.

  prgbUnboundData
     Receives a pointer to  a  buffer  containing  the  plaintext
     data.


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

     TSS_E_INVALID_HANDLE
          hEncData or hEncKey is not a valid handle.




TSS 1.1              Last change: 2004-05-25                    1






Introduction to Library Functions             Tspi_Data_Unbind(3)



     TSS_E_INTERNAL_ERROR
          An internal SW error has been detected.


     TSS_E_BAD_PARAMETER
          One or more parameters is bad.


     TSS_E_INVALID_ENCSCHEME
          Invalid encryption scheme.


     TSS_E_ENC_INVALID_LENGTH
          Invalid length of data to be encypted.


     TSS_E_ENC_NO_DATA
          No data to encrypt.


     TSS_E_ENC_INVALID_TYPE
          Invalid encryption type.



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


SEE ALSO
     Tspi_Data_Bind(3), Tspi_Data_Unseal(3), 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-25                    2