1
.\" Copyright (C) 2004 International Business Machines Corporation
2
.\" Written by Kathy Robertson 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_Key_CertifyKey" 3 "2004-05-26" "TSS 1.1" "TCG Software Stack Developer's Reference"
24
Tspi_Key_CertifyKey \- sign a public key.
29
.B #include <tss/platform.h>
30
.B #include <tss/tcpa_defines.h>
31
.B #include <tss/tcpa_typedef.h>
32
.B #include <tss/tcpa_struct.h>
33
.B #include <tss/tss_typedef.h>
34
.B #include <tss/tss_structs.h>
35
.B #include <tss/tspi.h>
37
.BI "TSS_RESULT Tspi_Key_CertifyKey(TSS_HKEY " hKey ", TSS_HKEY " hCertifyingKey ","
38
.BI " TSS_VALIDATION* " pValidationData ");"
45
\fBTspi_Key_CertifyKey\fR signs a public key.
49
Handle of the key object to be loaded.
52
Handle to the certifying key used to sign the addressed by hKey.
55
Pointer to a structure of the type TSS_VALIDATION. After successful completion of the call the member rgbValidationData of this structure contains the signature data of the command. The member prgbData of the structure points to a buffer containing a TCPA_CERTIFY_INFO data stream as specified within the TCPA 1.1b Main Specification.
58
\fBTspi_Key_CertifyKey\fR returns TSS_SUCCESS on success, otherwise one of the following values are returned:
60
.SM TSS_E_INVALID_HANDLE - Either \fIhKey\fR or \fIhCertifyingKey\fR are invalid handles.
62
.SM TSS_E_BAD_PARAMETER
64
.SM TSS_E_INTERNAL_ERROR - An error occurred internal to the TSS.
69
\fBTspi_Key_CertifyKey\fR conforms to the Trusted Computing Group Software Specification version 1.1 Golden
73
\fBTspi_Key_CreateKey\fR(3), \fBTspi_Key_WrapKey\fR(3).