1Tspi_Key_CreateMigraTtCiGonSBolfotbw(a3r)e Stack Developer'TsspRie_fKeerye_nCcreeateMigrationBlob(3)
2
3
4

NAME

6       Tspi_Key_CreateMigrationBlob - create a key blob suitable for migrating
7       to another TPM.
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_CreateMigrationBlob(TSS_HKEY hKeyToMigrate,          TSS_HKEY hParentKey,
19                                               UINT32   ulMigTicketLength,      BYTE*    rgbMigTicket,
20                                               UINT32*  pulRandomLength,        BYTE**   prgbRandom,
21                                               UINT32*  pulMigrationBlobLength, BYTE**   prgbMigrationBlob);
22
23

DESCRIPTION

25       Tspi_Key_CreateMigrationBlob returns a key blob containing an encrypted
26       section,  which will be different depending on the migration scheme in‐
27       dicated within the migration ticket previously created  by  the  method
28       Tspi_TPM_AuthorizeMigrationTicket().
29

PARAMETERS

31   hKeyToMigrate
32       Handle of the key object to migrate.
33
34   hParentKey
35       Handle to the parent key related to the key addressed by hKeyToMigrate.
36
37   ulMigTicketLength
38       The length (in bytes) of the rgbMigTickey parameter.
39
40   rgbMigTicket
41       Pointer to memory containing the migration ticket (migration public key
42       and its authorization digest).
43
44   pulRandomLength
45       On successful completion this parameter returns the random data  length
46       returned at the parameter prgbRandom.
47
48   prgbRandom
49       On successful completion this parameter returns the random data.
50
51   pulMigrationBlobLength
52       On  successful  completion this parameter returns the length of the mi‐
53       gration blob data returned at the parameter prgbMigrationBlob.
54
55   prgbMigrationBlob
56       On successful completion this  parameter  returns  the  migration  data
57       blob.
58

RETURN CODES

60       Tspi_Key_CreateMigrationBlob  returns TSS_SUCCESS on success, otherwise
61       one of the following values are returned:
62
63       TSS_E_INVALID_HANDLE - Either hKeyToMigrate, hParentKey or rgbMigTicket
64       are invalid parameters.
65
66       TSS_E_BAD_PARAMETER - One of the passed parameters is wrong.
67
68       TSS_E_KEY_NO_MIGRATION_POLICY - No migration policy picked.
69
70       TSS_E_INTERNAL_ERROR - An error occurred internal to the TSS.
71
72

CONFORMING TO

74       Tspi_Key_CreateMigrationBlob  conforms  to  the Trusted Computing Group
75       Software Specification version 1.1 Golden
76

SEE ALSO

78       Tspi_Key_CreateKey(3), Tspi_Key_CertifyKey(3).
79
80
81
82
83
84
85
86TSS 1.1                           2004-05-26   Tspi_Key_CreateMigrationBlob(3)
Impressum