Tspi_PcrComposite_GetPcrValue(3) TCG Software Stack Developer's Reference

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_SetPcrValue(3).


TSS 1.1 2004-05-26 Tspi_PcrComposite_GetPcrValue(3)