TSPI_CHANGEAUTH(3)

💖 Tspi_Change_Auth(3) 💖

okay bestie, welcome to the TCG Software Stack Developer's Reference ✨ this one's a lil glow-up page for your objects, fr fr.

🌸 NAME 🌸

Tspi_ChangeAuth — change the authorization data of an entity.

like… the secret password thing? yeah. we're swapping it. 💅

✨ 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 );

look at all those includes. she's prepared. she's got the whole TSS closet unpacked 🎀

🦋 DESCRIPTION 🦋

so Tspi_ChangeAuth changes the authorization data (that's the secret, the lil password vibe) of an entity — and yes, an entity is an object here, keep up bestie 😌 — and then it assigns the object to the policy object.

and the tea? all classes using secrets provide this method for changing their authorization data. every single one. it's giving universal. it's giving main character energy for every secret-holding class out there 👑

💜 PARAMETERS 💜

hObjectToChange

handle of the object you wanna change authorization for. the glow-up target 🫶

hParentObject

handle of the parent object — the one wrapping the object addressed by hObjectToChange. so like, your object has a parent. we respect that. we go through the parent. 💅

hNewPolicy

handle of the policy object that's providing the new authorization data. this is the new secret. the new era. the rebrand. ✨

🔥 RETURN CODES 🔥

Tspi_ChangeAuth returns TSS_SUCCESS on success — slay, we love a win 💖 — otherwise one of these lil guys comes back at you:

• TSS_E_INVALID_HANDLE — either hObjectToChange, or hParentObject are not a valid handle. 💀
• TSS_E_INTERNAL_ERROR — an error occurred internal to the TSS. not us, it's internal. it's their business. 🙈

🌈 CONFORMING TO 🌈

Tspi_ChangeAuth conforms to the Trusted Computing Group Software Specification version 1.1 Golden ⭐ yes ma'am, certified, spec-compliant, iconic.

🎀 SEE ALSO 🎀

• Tspi_ChangeAuthAsym(3) — the sibling. the asymmetric one. iykyk 👀

okay and for the sign-off, since you asked so nicely: this page is from TSS 1.1, dated 2004-05-26 — yeah she's vintage, but she still ate 💅✨ bye bestie, go change some auth data responsibly 🦋