1Tspi_Context_GetTpmObject(3)Library Functions ManualTspi_Context_GetTpmObject(3)
2
3
4
5                   TCG Software Stack Developers Reference
6

NAME

8       Context_GetTpmObject - get the handle of the TPM object associated with
9       a context.
10

SYNOPSIS

12       #include <tss/platform.h>
13       #include <tss/tcpa_defines.h>
14       #include <tss/tcpa_typedef.h>
15       #include <tss/tcpa_struct.h>
16       #include <tss/tss_typedef.h>
17       #include <tss/tss_structs.h>
18       #include <tss/tspi.h>
19
20       TSS_RESULT Tspi_Context_GetTpmObject(TSS_HCONTEXT hContext, TSS_HTPM* phTPM);
21
22
23

DESCRIPTION

25       Tspi_Context_GetTpmObject retrieves the TPM object of a  context.  Only
26       one  instance  of this object exists for a given context and implicitly
27       represents a TPM owner. This function is normally called at the  begin‐
28       ning  of  a  program,  right after the context is established. You must
29       have a context established prior to calling this function.
30
31

PARAMETERS

33   hContext
34       The hContext parameter is the handle of the context object (already ex‐
35       isting).
36
37   phTPM
38       The phTPM parameter is a pointer to where the handle of the TPM will be
39       placed.
40
41

RETURN CODES

43       Tspi_Context_GetTpmObject returns TSS_SUCCESS on success, otherwise one
44       of the following values is returned:
45
46       TSS_E_INVALID_HANDLE
47              hContext is not a valid handle.
48
49
50       TSS_E_INTERNAL_ERROR
51              An internal SW error has been detected.
52
53
54       TSS_E_BAD_PARAMETER
55              One or more of the parameters is incorrect.
56
57

CONFORMING TO

59       Tspi_Context_GetTpmObject conforms to the Trusted Computing Group Soft‐
60       ware Specification version 1.1 Golden
61
62

SEE ALSO

64       Tspi_Context_Create(3), Tspi_Context_Connect(3), Tspi_Context_FreeMemo‐
65       ry(3), Tspi_Context_Close(3).
66
67
68
69
70TSS 1.1                           2004-05-25      Tspi_Context_GetTpmObject(3)
Impressum