DragonFly On-Line Manual Pages

Search: Section:  

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)

Search: Section: