---
name: "Tspi_ChangeAuth"
section: "3"
platform: "linux"
package: "libtspi-dev"
version: "0.3.15-0.4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Tspi_ChangeAuth"
---

# Tspi\_ChangeAuth(3)

change the authorization data of an entity.

## NAME

Tspi\_ChangeAuth - change the authorization data of an entity.

## 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\_ChangeAuth(TSS\_HOBJECT** *hObjectToChange***, TSS\_HOBJECT** *hParentObject***,**
                            **TSS\_HPOLICY** *hNewPolicy* **);**

## DESCRIPTION

**Tspi\_ChangeAuth**  changes the authorization data (secret) of an entity (object) and assigns the object to the policy object. All classes using secrets provide this method for changing their authorization data.

## PARAMETERS

### hObjectToChange

Handle of the object to change authorization for.

### hParentObject

Handle of the parent object wrapping the object addressed by hObjectToChange.

### hNewPolicy

Handle of the policy object providing the new authorization data.

## RETURN CODES

**Tspi\_ChangeAuth** returns TSS\_SUCCESS on success,otherwise one of the following values are returned:
 TSS\_E\_INVALID\_HANDLE - Either *hObjectToChange*, or *hParentObject* are not a valid handle.
 TSS\_E\_INTERNAL\_ERROR - An error occurred internal to the TSS.

## CONFORMING TO

**Tspi\_ChangeAuth** conforms to the Trusted Computing Group Software Specification version 1.1 Golden

## SEE ALSO

[**Tspi\_ChangeAuthAsym**(3)](/Tspi_ChangeAuthAsym/3.md).