Tspi_TPM_GetEvents - get a specific number of PCR events for a given index.
#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);
TCG Software Stack Developer's Reference Tspi_TPM_GetEvents(3)
NAME
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
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+---------------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+---------------------------+
|Availability | library/security/trousers |
+---------------+---------------------------+
|Stability | Uncommitted |
+---------------+---------------------------+
SEE ALSO
Tspi_TPM_GetEvent(3) Tspi_TPM_GetEventLog(3).
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at https://github.com/or-
acle/solaris-userland. The original community source was downloaded
from https://source-
forge.net/projects/trousers/files/trousers/0.3.15/trousers-0.3.15.tar.gz.
Further information about this software can be found on the open source
community website at http://trousers.sourceforge.net/.
TSS 1.1 2004-05-26 Tspi_TPM_GetEvents(3)