Tspi_TPM_GetEventLog

Section: TCG Software Stack Developer's Reference (3)
Updated: 2004-05-26
Index Return to Main Contents

NAME

Tspi_TPM_GetEventLog- get the entire PCR event log.

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_GetEventLog(TSS_HTPM        hTPM, UINT32* pulEventNumber,
                                TSS_PCR_EVENT** prgPcrEvents);

DESCRIPTION

Tspi_TPM_GetEventLog provides the whole event log that was used to create all of the PCRs.

PARAMETERS

hTPM

Handle of the TPM object.

pulEventNumber

Receives number of returned event data structures in prgPcrEvents parameter.

prgPcrEvents

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

RETURN CODES

Tspi_TPM_GetEventLog 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_GetEventLog conforms to the Trusted Computing Group Software Specification version 1.1 Golden