1
.\" Copyright (C) 2004 International Business Machines Corporation
2
.\" Written by Megan Schneider based on the Trusted Computing Group Software Stack Specification Version 1.1 Golden
12
.de Sp \" Vertical space (when we can't use .PP)
18
.ie \\n(.$>=3 .ne \\$3
22
.TH "Tspi_Data_Unbind" 3 "2004-05-25" "TSS 1.1"
24
TCG Software Stack Developer's Reference
26
Tspi_Data_Unbind \- Decrypts data that has been bound to a key
31
.B #include <tss/platform.h>
32
.B #include <tss/tcpa_defines.h>
33
.B #include <tss/tcpa_typedef.h>
34
.B #include <tss/tcpa_struct.h>
35
.B #include <tss/tss_typedef.h>
36
.B #include <tss/tss_structs.h>
37
.B #include <tss/tspi.h>
39
.BI "TSS_RESULT Tspi_Data_Unbind(TSS_HENCDATA " hEncData ", TSS_HKEY " hEncKey ","
40
.BI " UINT32* " pulUnboundDataLength ", BYTE** " prgbUnboundData ");"
48
\fBTspi_Data_Unbind\fR decrypts the encrypted data
49
blob exportedfrom the data object used in \fBTspi_Data_Bind\fR. The
50
encrypted data blob must be imported to the object addressed by
51
\fBTspi_SetAttribData\fR before calling this method.
56
The handle of the data object which contains the encrypted data.
58
Handle to the key object addressing the private key which is used
61
Receives the length of the data at the parameter \fIprgbUnboundData\fR.
63
Receives a pointer to a buffer containing the plaintext data.
67
\fBTspi_Data_Unbind\fR returns TSS_SUCCESS on success, otherwise one
68
of the following values is returned:
70
.SM TSS_E_INVALID_HANDLE
71
\fIhEncData\fR or \fIhEncKey\fR is not a valid handle.
74
.SM TSS_E_INTERNAL_ERROR
75
An internal SW error has been detected.
78
.SM TSS_E_BAD_PARAMETER
79
One or more parameters is bad.
82
.SM TSS_E_INVALID_ENCSCHEME
83
Invalid encryption scheme.
86
.SM TSS_E_ENC_INVALID_LENGTH
87
Invalid length of data to be encypted.
94
.SM TSS_E_ENC_INVALID_TYPE
95
Invalid encryption type.
101
\fBTspi_Data_Unbind\fR conforms to the Trusted Computing Group Software
102
Specification version 1.1 Golden
107
\fBTspi_Data_Bind\fR(3), \fBTspi_Data_Unseal\fR(3),
108
\fBTspi_Data_Seal\fR(3).