Tspi_TPM_Quote2 - retreive a signed set of PCR values with a more complete view than Tspi_TPM_Quote.

Conforming To

Tspi_TPM_Quote2 conforms to the Trusted Computing Group Software Specification version 1.2

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.

Name

       Tspi_TPM_Quote2 - retreive a signed set of PCR values with a more complete view 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 fAd‐
       dVersion 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.

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_RESULTTspi_TPM_Quote2(TSS_HTPMhTPM,TSS_HKEYhIdentKey,TSS_BOOLfAddVersion,TSS_HPCRShPcrComposite,TSS_VALIDATION*pValidationData,UINT32*versionInfoSize,BYTE**versionInfo);