1Tspi_TPM_LoadMaintenancePubKLeiyb(r3a)ry Functions MTasnpuia_lTPM_LoadMaintenancePubKey(3)
2
3
4
5                   TCG Software Stack Developer's Reference
6

NAME

8       Tspi_TPM_LoadMaintenancePubKey-  load  the  public maintenance key into
9       the TPM
10

SYNOPSIS

12       #include <tss/platform.h>
13       #include <tss/tcpa_defines.h>
14       #include <tss/tcpa_typedef.h>
15       #include <tss/tcpa_struct.h>
16       #include <tss/tss_typedef.h>
17       #include <tss/tss_structs.h>
18       #include <tss/tspi.h>
19
20       TSS_RESULT Tspi_TPM_LoadMaintenancePubKey(TSS_HTPM        hTPM, TSS_HKEY hMaintenanceKey,
21                                                 TSS_VALIDATION* pValidationData);
22
23
24

DESCRIPTION

26       Tspi_TPM_LoadMaintenancePubKey loads the public  maintenance  key  into
27       the  TPM.  The  maintenance key can only be loaded once; any subsequent
28       calls to this function will fail. The key information for  loading  the
29       maintenance public key must be set in the key object by Tspi_SetAttrib‐
30       Data before this method is called. If pValidationData is NULL, the  TSS
31       service  provider proofs the digest got internally from the TPM. Other‐
32       wise, the caller has to proof the digest by its own.
33

PARAMETERS

35   hTPM
36       Handle of the TPM object
37
38   hMaintenanceKey
39       Handle of the maintenance key object
40
41   pValidationData
42       Validation data structure.  [IN] Provide externalData  information  re‐
43       quired to compute the signature.  [OUT] On successful completion of the
44       ocmmand, the structure provides a buffer containing the validation data
45       and a buffer containing the data the validation data was computed from.
46
47

RETURN CODES

49       Tspi_TPM_LoadMaintenancePubKey  returns  TSS_SUCCESS on success, other‐
50       wise one of the following values are returned:
51
52       TSS_E_INVALID_HANDLE
53              hTPM or hMaintenanceKey is not a valid handle.
54
55       TSS_E_INTERNAL_ERROR
56              An internal SW error has been detected.
57
58       TSS_E_BAD_PARAMETER
59              One or more of the parameters is incorrect.
60
61       TSS_E_NOTIMPL
62              The command is not implemented.
63
64

CONFORMING TO

66       Tspi_TPM_LoadMaintenancePubKey conforms to the Trusted Computing  Group
67       Software Specification version 1.1 Golden
68

SEE ALSO

70       Tspi_TPM_CheckMaintenancePubKey(3), Tspi_TPM_KillMaintenanceFeature(3),
71       Tspi_TPM_CreateMaintenanceArchive(3).
72
73
74
75
76
77
78TSS 1.1                           2004-05-26 Tspi_TPM_LoadMaintenancePubKey(3)
Impressum