Tspi_C...ByUUID(3)

💖 Tspi_Context_LoadKeyByUUID — from the TCG Software Stack Developer's Reference ✨

okay bestie, buckle up, because this one is literally about pulling a key out of persistent storage and yeeting it into your TPM. it's giving "my key was here the whole time, I just needed the receipt." 🎀

🌸 NAME 🌸

Tspi_Context_LoadKeyByUUID — load a key that's been registered in persistent storage. 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_Context_LoadKeyByUUID(TSS_HCONTEXT hContext, TSS_FLAG persistentStorageType,
                                      TSS_UUID     uuidData, TSS_HKEY* phKey);

look at those includes, so many headers, she's high maintenance but she's worth it 🫶

✨ DESCRIPTION ✨

so TSS_Context_LoadKeyByUUID (yes, that's how the original spells it, no I will not be fixing it, we respect the ancestors 💀) builds a key object out of the info it grabs from the manager using the UUID, and then loads that key into the TPM.

and here's the cute part: the persistent storage hands over all the info you need to load the parent keys too, like the whole family tree, so the key associated with the given UUID can actually get loaded. no cap. 🌈

👑 PARAMETERS 👑

hContext

the handle of the context object. your main character, the one holding everything together 💖

persistentStorageType

a flag saying which persistent storage the key is registered in. should be either TSS_PS_TYPE_USER or TSS_PS_TYPE_SYSTEM. pick one, bestie, don't be shy ⭐

uuidData

the UUID of the key — the one it was registered under in the persistent storage (TSP or connected TCS). it's basically the key's government name 🎀

phKey

receives the handle of the key object that represents the loaded key. this is your souvenir from the whole trip 🍓

💀 RETURN CODES 💀

Tspi_Context_LoadKeyByUUID returns TSS_SUCCESS on success — slay — otherwise one of these little gremlins comes back:

• TSS_E_INVALID_HANDLE — hContext is an invalid handle. she does not know her. 🙈
• TSS_E_BAD_PARAMETER — persistentStorageType is not valid. wrong flag, wrong vibe, blocked. 😭
• TSS_E_INTERNAL_ERROR — an error occurred internal to the TSS. not us, not you, it's internal. it's giving private drama.

🧚 CONFORMING TO 🧚

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

💜 SEE ALSO 💜

• Tspi_Context_LoadKeyByBlob(3)
• Tspi_Key_LoadKey(3)

go read those too, iykyk 🦋

and that's the whole page, bestie!! this one's from the TCG Software Stack Developer's Reference, page Tspi_C...ByUUID(3), and it's stamped TSS 1.1 from way back on 2004-05-26 🌸 she's vintage, she's valid, she ate. mwah 💅✨