1Tspi_Key_CreateKey(3T)CG Software Stack Developer's ReferencTespi_Key_CreateKey(3)
2
3
4

NAME

6       Tspi_Key_CreateKey - create a key pair within the TPM, wrapping it with
7       the key addressed by hWrappingKey.
8

SYNOPSIS

10       #include <tss/platform.h>
11       #include <tss/tcpa_defines.h>
12       #include <tss/tcpa_typedef.h>
13       #include <tss/tcpa_struct.h>
14       #include <tss/tss_typedef.h>
15       #include <tss/tss_structs.h>
16       #include <tss/tspi.h>
17
18       TSS_RESULT Tspi_Key_CreateKey(TSS_HKEY hKey, TSS_HKEY hWrappingKey, TSS_HPCRS hPcrComposite);
19
20

DESCRIPTION

22       TSS_Key_CreateKey calls the TPM command TPM_CreateWrapKey. If  hPcrCom‐
23       posite  is  not  set to NULL, the created key blob is bound to this PCR
24       values. The key object addressed by hKey must contain the key  informa‐
25       tion needed for the creation.
26

PARAMETERS

28   hKey
29       The handle of the key object to create.
30
31   hWrappingKey
32       The handle to the key used to wrap the newly created key.
33
34   hPcrComposite
35       The handle to an object, if the value of the handle doesn't equal NULL,
36       the newly create key will be bound ot the  PCR  values  described  with
37       this object.
38
39

RETURN CODES

41       Tspi_Key_CreateKey returns TSS_SUCCESS on success, otherwise one of the
42       following values are returned:
43
44       TSS_E_INVALID_HANDLE - Either hKey, hWrappingKey or  hPcrComposite  are
45       invalid parameters.
46
47       TSS_E_INTERNAL_ERROR - An error occurred internal to the TSS.
48

CONFORMING TO

50       Tspi_Key_CreateKey  conforms  to  the  Trusted Computing Group Software
51       Specification version 1.1 Golden
52

SEE ALSO

54       Tspi_Key_WrapKey(3), Tspi_Key_CertifyKey(3), Tspi_Key_RegisterKey(3).
55
56
57
58TSS 1.1                           2004-05-26             Tspi_Key_CreateKey(3)