1Tspi_TPM_Quote2(3) TCG Software Stack Developer's Reference Tspi_TPM_Quote2(3)
2
3
4

NAME

6       Tspi_TPM_Quote2  - retreive a signed set of PCR values with a more com‐
7       plete view than Tspi_TPM_Quote.
8

SYNOPSIS

10       #include <tss/platform.h>
11       #include <tss/tcpa_defines.h>
12       #include <tss/tcpa_typedef.h>
13       #include <tss/tcpa_struct.h>
14       #include <tss/tss_typedef.h>
15       #include <tss/tss_structs.h>
16       #include <tss/tspi.h>
17
18       TSS_RESULT Tspi_TPM_Quote2(TSS_HTPM  hTPM,          TSS_HKEY        hIdentKey,
19                                 TSS_BOOL   fAddVersion,     TSS_HPCRS   hPcrComposite,
20                                 TSS_VALIDATION* pValidationData, UINT32* versionInfoSize,
21                                 BYTE**  versionInfo);
22
23

DESCRIPTION

25       Tspi_TPM_Quote2 quotes a TCG system, providing  the  requestor  with  a
26       more   complete  view  of  the  current  platform  configuration,  than
27       Tspi_TPM_Quote.
28
29

PARAMETERS

31   hTPM
32       Handle of the TPM object.
33
34   hIdentKey
35       Handle of the signature key object.
36
37   fAddVersion
38       If TRUE, the TPM version is added to the output. If FALSE, the TPM ver‐
39       sion isn't added to the output.
40
41   hPcrComposite
42       Handle of the PCR composite object, which contains the PCRs to be quot‐
43       ed.
44
45   pValidationData
46       Validation data structure [IN]  Provide  externalData  information  re‐
47       quired to compute the signature.  [OUT] On successful completion of the
48       command, the structure provides a buffer containing the validation data
49       and a buffer containing the data the validation data was computed form.
50
51   versionInfoSize
52       The  size of the bytestream returned by versionInfo. If the fAddVersion
53       is False this is zero.
54
55   versionInfo
56       The version information returned as a byte stream reflecting  the  data
57       in TSS_CAP_VERSION_INFO if the fAddVersion is TRUE. Else it's NULL.
58

RETURN CODES

60       Tspi_TPM_Quote  returns  TSS_SUCCESS  on  success, otherwise one of the
61       following values are returned:
62
63       TSS_E_INVALID_HANDLE - hTPM, hIdentKey or hPcrComposite is not a  valid
64       handle.
65
66       TSS_E_BAD_PARAMETER
67
68       TSS_E_INTERNAL_ERROR - An error occurred internal to the TSS.
69
70

CONFORMING TO

72       Tspi_TPM_Quote2 conforms to the Trusted Computing Group Software Speci‐
73       fication version 1.2
74

SEE ALSO

76       Tspi_TPM_Quote(3).
77
78
79
80
81
82
83TSS 1.2                           2007-04-03                Tspi_TPM_Quote2(3)
Impressum