---
name: "Tspi_PcrComposite_GetPcrValue"
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_PcrComposite_GetPcrValue"
---

# Tspi\_PcrComposite\_GetPcrValue(3)

get the digest value of a given PCR index inside a PCR composite object.

## NAME

Tspi\_PcrComposite\_GetPcrValue - get the digest value of a given PCR index inside a PCR composite object.

## 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\_PcrComposite\_GetPcrValue(TSS\_HPCRS** *hPcrComposite***,    UINT32** *ulPcrIndex***,**
                                          **UINT32\***   *ulPcrValueLength***, BYTE\*\*** *rgbPcrValue***);**

## DESCRIPTION

**Tspi\_PcrComposite\_GetPcrValue** returns the digest value of a given PCR index inside a PCR composite object.

## PARAMETERS

### hPcrComposite

Handle of the PCR composite object instance where a PCR value should be returned.

### ulPcrIndex

This parameter indicates the index of the PCR to read.

### ulPcrValueLength

The length (in bytes) of the rgbPcrValue parameter.

### rgbPcrValue

After successful completion this parameter recieves a pointer to the memory block containing the PCR value of the PCR indicated by ulPcrIndex.

## RETURN CODES

**Tspi\_PcrComposite\_GetPcrValue** returns TSS\_SUCCESS on success, otherwise one of the following values are returned:
 TSS\_E\_INVALID\_HANDLE - Either *hPcrComposite* or *ulPcrIndex* is an invalid parameter.
 TSS\_E\_INTERNAL\_ERROR - An error occurred internal to the TSS.

## CONFORMING TO

**Tspi\_PcrComposite\_GetPcrValue** conforms to the Trusted Computing Group Software Specification version 1.1 Golden

## SEE ALSO

[**Tspi\_PcrComposite\_SelectPcrIndex**(3)](/Tspi_PcrComposite_SelectPcrIndex/3.md), [**Tspi\_PcrComposite\_SetPcrValue**(3)](/Tspi_PcrComposite_SetPcrValue/3.md).