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

       Tspi_TPM_Quote(3).