Tspi_C...Object(3)

💖 Tspi_C...Object(3) 💖

okay bestie, welcome to the TCG Software Stack Developer's Reference — yes that's the manual name, and yes it's a whole vibe. sit down, grab a boba, we're learning how to close an object. it's giving "spring cleaning but for handles" 🧹✨

🌸 NAME 🌸

Tspi_Context_CloseObject — destroy resources associated with an object handle.

like, literally destroy them. not "hide them in a drawer". destroy. 💅

✨ SYNOPSIS ✨

first you gotta pull in the whole friend group, no skipping:

#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>

and then the actual moment:

TSS_RESULT Tspi_Context_CloseObject(TSS_HCONTEXT hContext, TSS_HOBJECT hObject);

that's it. two args. she's lowkey simple but highkey important. 🫶

🦋 DESCRIPTION 🦋

so TSS_Context_CloseObject destroys the object that's associated with the object handle. and the way that it does that? all the allocated resources that live inside that object get released too. gone. freed. main character exit. 🚪💨

no leftover crumbs, no ghost resources haunting your process. periodt.

🎀 PARAMETERS 🎀

hContext

the handle of the context object. your home base, your safe space, the group chat the object was living in. 💬

hObject

the handle of the object that's about to be destroyed. say your goodbyes, bestie. 😭

⭐ RETURN CODES ⭐

Tspi_Context_CloseObject returns TSS_SUCCESS when everything slays, otherwise one of these little guys shows up to ruin the mood:

• TSS_E_INVALID_HANDLE — either hContext or hObject are invalid handles. bestie… that handle isn't real. 🙈
• TSS_E_INTERNAL_ERROR — an error happened internal to the TSS. not your fault (probably), it's just messy inside. 💀

👑 CONFORMING TO 👑

Tspi_Context_CloseObject conforms to the Trusted Computing Group Software Specification version 1.1 Golden — yes, Golden. iconique behaviour only. ⭐

🌈 SEE ALSO 🌈

• Tspi_Context_CreateObject(3) — because every close needs a create first, iykyk. 🦋

TSS 1.1 · 2004-05-26 — yeah she's an elder but she still ate. that's the version and the date right there in the footer, and honestly? timeless. 💖✨🎀