table of contents
| Tspi_TPM_Quote2(3) | TCG Software Stack Developer's Reference | Tspi_TPM_Quote2(3) |
NAME¶
Tspi_TPM_Quote2 - retreive a signed set of PCR values with a more complete view than Tspi_TPM_Quote.
SYNOPSIS¶
#include <tss/platform.h>
#include <tss/tcpa_defines.h>
#include <tss/tcpa_typedef.h>
#include <tss/tcpa_struct.h>
#include <tss/tss_typedef.h>
#include <tss/tss_structs.h>
#include <tss/tspi.h>
TSS_RESULT Tspi_TPM_Quote2(TSS_HTPM hTPM, TSS_HKEY hIdentKey,
TSS_BOOL fAddVersion, TSS_HPCRS hPcrComposite,
TSS_VALIDATION* pValidationData, UINT32* versionInfoSize,
BYTE** versionInfo);
DESCRIPTION¶
Tspi_TPM_Quote2 quotes a TCG system, providing the requestor with a more complete view of the current platform configuration, than Tspi_TPM_Quote.
PARAMETERS¶
hTPM¶
Handle of the TPM object.
hIdentKey¶
Handle of the signature key object.
fAddVersion¶
If TRUE, the TPM version is added to the output. If FALSE, the TPM version isn't added to the output.
hPcrComposite¶
Handle of the PCR composite object, which contains the PCRs to be quoted.
pValidationData¶
Validation data structure [IN] Provide externalData information required to compute the signature. [OUT] On successful completion of the command, the structure provides a buffer containing the validation data and a buffer containing the data the validation data was computed form.
versionInfoSize¶
The size of the bytestream returned by versionInfo. If the fAddVersion is False this is zero.
versionInfo¶
The version information returned as a byte stream reflecting the data in TSS_CAP_VERSION_INFO if the fAddVersion is TRUE. Else it's NULL.
RETURN CODES¶
Tspi_TPM_Quote returns TSS_SUCCESS on success, otherwise one of the following values are returned:
- TSS_E_INVALID_HANDLE - hTPM, hIdentKey or hPcrComposite is not a valid handle.
- TSS_E_BAD_PARAMETER
- TSS_E_INTERNAL_ERROR - An error occurred internal to the TSS.
CONFORMING TO¶
Tspi_TPM_Quote2 conforms to the Trusted Computing Group Software Specification version 1.2
SEE ALSO¶
| 2007-04-03 | TSS 1.2 |