Tspi_Polic...gnToObject(3)

💖 Tspi_Policy_AssignToObject(3) 💖

okay bestie, gather round, because this one is from the TCG Software Stack Developers Reference (the TSS girlies know) and it's literally about giving a policy to an object so the object knows how to behave. it's giving "here's your hall pass" energy. 🎀

✨ NAME ✨

Tspi_Policy_AssignToObject — assign a policy to an object. that's it, that's the whole job. 💅

🌸 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_Policy_AssignToObject(TSS_HPOLICY hPolicy, TSS_HOBJECT hObject);

like yes, that's a lot of includes. do not skip them. they are load-bearing. 😭

🦋 DESCRIPTION 🦋

so Tspi_Policy_AssignToObject assigns a given object to a certain policy. that's the whole vibe. once it's assigned, the object then uses its assigned policy to process an authorized TPM command. main character object, doing main character things, but only because its policy said so. ✨

here's the tea tho: when each new object is initialized, it gets assigned to the default policy, and that default policy is created when a context object is created. so nobody starts out policy-less, bestie, everyone has a vibe from day one. 🫶

and when an object is assigned to a policy, a reference is added to the list of assigned objects stored in the policy, and a reference to the policy is stored in the object by internal object functions. so it's a mutual thing. both sides are keeping receipts. 💀 lowkey romantic.

💜 PARAMETERS 💜

🎀 hPolicy

the hPolicy parameter is the handle of the policy object to be assigned to. it's the one doing the adopting. 👑

🎀 hObject

the hObject parameter is the object that will be assigned to hPolicy. it's the one getting adopted. 🥺

🔥 RETURN CODES 🔥

Tspi_Policy_AssignToObject returns TSS_SUCCESS on success. slay. otherwise one of these lil guys comes back at you:

• TSS_E_INVALID_HANDLE — hPolicy is not a valid handle. bestie that handle is not real, no cap. 😭
• TSS_E_INTERNAL_ERROR — an internal SW error has been detected. not your fault, not our fault, it's just an internal situation. 💀

🌈 CONFORMING TO 🌈

Tspi_Policy_AssignToObject conforms to the Trusted Computing Group Software Specification version 1.1 Golden. iconic, certified, periodt. ⭐

👑 SEE ALSO 👑

• Tspi_Policy_SetSecret(3)
• Tspi_Policy_FlushSecret(3)

ngl if you're assigning policies you're probably gonna wanna know about setting and flushing secrets too, so go read those next. iykyk. 💖

and that's the whole page, bestie! this one's from TSS 1.1, dated 2004-05-25 — yes she's an elder but she's still serving. mwah, go assign some policies. 🧚‍♀️💅🍓