---
name: "Tspi_TPM_Quote2"
section: "3"
platform: "linux"
package: "libtspi-dev"
version: "0.3.15-0.4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Tspi_TPM_Quote2"
---

# Tspi\_TPM\_Quote2(3)

retreive a signed set of PCR values with a more complete view than Tspi\_TPM\_Quote.

## 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)](/Tspi_TPM_Quote/3.md).