Tspi_TPM_GetEvents - Man Page

Tspi_TPM_GetEvents- get a specific number of PCR events for a given index.

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_GetEvents(TSS_HTPM       hTPM,            UINT32  ulPcrIndex, 
                              UINT32         ulStartNumber,   UINT32* pulEventNumber, 
                              TSS_PCR_EVENT* prgbPcrEvents);

Description

Tspi_TPM_GetEvents provides a specific number of PCR events for a given index.

Parameters

hTPM

Handle of the TPM object.

ulPcrIndex

Index of the PCR to request.

ulStartNumber

Indext of the first event to request

pulEventNumber

[IN] Number of elements to request. [OUT] Receives number of returned event data structures in prgbPcrEvents parameter.

prgbPcrEvents

Receives a pointer to an array of PCR event data. If NULL, only the number of elements is returned in pulEventNumber parameter.

Return Codes

Tspi_TPM_GetEvents returns TSS_SUCCESS on success, otherwise one of the following values are returned:

TSS_E_INVALID_HANDLE

hTPM is not a valid handle to the TPM object.

TSS_E_INTERNAL_ERROR

An error occurred internal to the TSS.

Conforming to

Tspi_TPM_GetEvents conforms to the Trusted Computing Group Software Specification version 1.1 Golden

See Also

Tspi_TPM_GetEvent(3) Tspi_TPM_GetEventLog(3).

Referenced By

Tspi_TPM_GetEvent(3), Tspi_TPM_GetEventLog(3).

2004-05-26 TSS 1.1 TCG Software Stack Developer's Reference