Tspi_GetAttribUint32(3)

💖 Tspi_GetAttribUint32(3) 💖

okay so this is from the Library Functions Manual bestie, and it's giving ✨ TCG Software Stack Developers Reference ✨ energy. come sit with me, we're gonna read this together and it's gonna slay.

🌸 NAME 🌸

Tspi_GetAttribUint32 — get the value of a particular attribute associated with a given class or object 💅

✨ SYNOPSIS ✨

first things first, you gotta include all your lil header files, 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>

then here's the actual function signature, look at her:

TSS_RESULT Tspi_GetAttribUint32(TSS_HOBJECT hObject, TSS_FLAG attribFlag,
                                TSS_FLAG    subFlag, UINT32*  pulAttrib);

🦋 DESCRIPTION 🦋

so Tspi_GetAttribUint32 returns a specified uint32 attribute that's associated with a given class or object. that's the whole gig, she's a getter, she gets. 🫶

but wait — in order to use this command, you must first create an object and then find the attributes you wish to set. like, you can't just walk up and ask for an attribute that doesn't exist yet, the object has to be there first, periodt. 👑

🎀 PARAMETERS 🎀

hObject

the hObject parameter is the handle of the object you wanna retrieve the attribute from. it's the "who are we talking about" of the whole situation.

attribFlag

the attribFlag parameter indicates the specific attribute to query. this is your main character flag, it says what you're asking for. 🔥

subFlag

the subFlag parameter also indicates the specific attribute to query. yeah, two flags, both saying what you want, that's just how she is, we don't make the rules. 🙈

pulAttrib

the pulAttrib parameter is a pointer to the location where the attribute value gets returned. that's where the answer lands, bestie. 📬

💀 RETURN CODES 💀

Tspi_GetAttribUint32 returns TSS_SUCCESS on success 🎉 — otherwise one of the following values is returned, and honestly? it's a lil list of ways things went wrong:

• TSS_E_INVALID_HANDLE — hObject is not a valid handle. (she doesn't know who you're talking about 😭)
• TSS_E_INVALID_ATTRIB_FLAG — attribFlag is incorrect.
• TSS_E_INVALID_ATTRIB_SUBFLAG — subFlag is incorrect.
• TSS_E_INVALID_ATTRIB_DATA — pulAttrib is incorrect.
• TSS_E_INTERNAL_ERROR — an internal SW error has been detected. (not your fault, the vibes inside are just off 💀)
• TSS_E_BAD_PARAMETER — one or more parameters is bad.

🌈 CONFORMING TO 🌈

Tspi_GetAttribUint32 conforms to the Trusted Computing Group Software Specification version 1.1 Golden ⭐ like, she's certified, she's official, she's on the spec.

🧚 SEE ALSO 🧚

go check out her siblings, they're all iconic in their own way:

• Tspi_GetAttribData(3)
• Tspi_SetAttribUint32(3)
• Tspi_SetAttribData(3)

and that's the whole page, no notes, 10/10 💖

this lil reference comes to you from TSS 1.1, dated 2004-05-25 — yeah she's an elder but she still ate 💅✨ bye bestie, go get those attributes 🎀🦋