1Tspi_ChangeAuthAsym(T3C)G Software Stack Developer's ReferenTcsepi_ChangeAuthAsym(3)
2
3
4

NAME

6       Tspi_ChangeAuthAsym  - change the authorization data of an entity using
7       asymmetric change protocol.
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_ChangeAuthAsym(TSS_HOBJECT hObjectToChange, TSS_HOBJECT hParentObject,
19                                      TSS_HKEY    hIdentKey,       TSS_HPOLICY hNewPolicy);
20
21
22

DESCRIPTION

24       Tspi_ChangeAuthAsym  changes the authorization data (secret) of an  en‐
25       tity  (object) utilizing the asymmetric change protocol and assigns the
26       object to the policy object. All classes  using  secrets  provide  this
27       method  for changing their authorization data.  This method changes the
28       authorization data of an object ensuring that the parent of the  object
29       does not get knowledge of the new secret.
30

PARAMETERS

32   hObjectToChange
33       Handle of the object the authorization data should be changed.
34
35   hParentObject
36       Handle  of  the parent object wrapping the object addressed by hObject‐
37       ToChange.
38
39   hIdentKey
40       Handle of the identity key object required to proof the internally cre‐
41       ated temporary key.
42
43   hNewPolicy
44       Handle of the policy object providing the new authorization data.
45

RETURN CODES

47       Tspi_ChangeAuthAsym  returns  TSS_SUCCESS  on success, otherwise one of
48       the following values are returned:
49
50       TSS_E_INVALID_HANDLE - Either hObjectToChange, hParentObject, or hIden‐
51       tKey is an invalid handle.
52
53       TSS_E_INTERNAL_ERROR - An error occurred internal to the TSS.
54
55

CONFORMING TO

57       Tspi_ChangeAuthAsym  conforms  to  the Trusted Computing Group Software
58       Specification version 1.1 Golden
59

SEE ALSO

61       Tspi_ChangeAuth(3).
62
63
64
65TSS 1.1                           2004-05-26            Tspi_ChangeAuthAsym(3)
Impressum