Tspi_TPM_GetEvent

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

NAME

Tspi_TPM_GetEvent- get a PCR event for a given PCR index and event number.  

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_GetEvent(TSS_HTPM hTPM,          UINT32         ulPcrIndex,
                             UINT32   ulEventNumber, TSS_PCR_EVENT* pPcrEvent);

 

DESCRIPTION

Tspi_TPM_GetEvent provides a PCR event for a given PCR index and event number.  

PARAMETERS

 

hTPM

Handle of the TPM object.

 

ulPcrIndex

Index of the PCR to request.

 

ulEventNumber

Index of the event to request.

 

pPcrEvent

Receives the PCR event data.  

RETURN CODES

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

SEE ALSO

Tspi_TPM_GetEvents(3) Tspi_TPM_GetEventLog(3).