Tspi_Policy_FlushSecret(3)

💖 Tspi_Policy_FlushSecret(3) 💖

okay bestie, so this one's from the Library Functions Manual (that's the manual name, keep it in your notes 📝) and it's genuinely such a little cutie. short page, big "clean up your mess" energy. let's go ✨

✨ NAME ✨

Tspi_Policy_FlushSecret — flush a cached secret 💅

🌸 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_FlushSecret(TSS_HPOLICY hPolicy);

like yes, that's a LOT of #include lines, but you literally just copy-paste them and vibe. the whole API lives in tss/tspi.h land, and all seven of these headers are coming along for the ride. 🦋

🎀 DESCRIPTION 🎀

Tspi_Policy_FlushSecret tells the TSS to flush a secret that it had cached for a user.

that's it. that's the whole plot. 🫶 the TSS was holding onto a secret for a user, and this function is you going "okay bestie, we're done here, let it go". not me being emotional about a cache invalidation function 😭

💜 PARAMETERS 💜

hPolicy

the hPolicy parameter is the handle of the policy object to be flushed. that's the one you're sending to the void. 🌈

⭐ RETURN CODES ⭐

Tspi_Policy_FlushSecret returns TSS_SUCCESS on success — slay, that's the good ending 👑 — otherwise one of the following values is returned:

• TSS_E_INVALID_HANDLE — hPolicy is not a valid handle. like, this handle is giving nothing, it's not real, we cannot work with this 💀
• TSS_E_INTERNAL_ERROR — an internal SW error has been detected. not your fault, something inside the stack simply woke up and chose chaos 🙈

🔥 CONFORMING TO 🔥

Tspi_Policy_FlushSecret conforms to the Trusted Computing Group Software Specification version 1.1 Golden. so it's officially official, no cap. ✨

🦋 SEE ALSO 🦋

• Tspi_Policy_SetSecret(3)
• Tspi_Policy_AssignToObject(3)

go read those next, bestie, the lore is connected iykyk 📚

ok real talk for one sec: this page only documents the two error returns above, so if you see anything else come back, that's outside what's written here. don't be out here guessing, fr fr. 🍓

and that's the whole page!! mwah 💖 this was TSS 1.1, dated 2004-05-25, and honestly? iconic. periodt. 🎀🧚‍♀️💅