Tspi_C...onnect(3)

πŸ“¦
version 0.3.15 Β· 2 versions
, in epel 10, epel 9, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0

πŸ’– Tspi_Context_Connect β€” from the TCG Software Stack Developer's Reference (section 3) πŸ’–

okay bestie, gather round, because today we're connecting a TSP to a Core Services daemon and honestly? it's giving ✨*networking but make it trusted*✨


🌸 NAME 🌸

Tspi_Context_Connect β€” connect a TSP to a Core Services daemon. yes that is literally the whole job. one (1) job. and she does it slayfully πŸ’…


πŸ¦‹ 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_Connect(TSS_HCONTEXT hLocalContext, UNICODE* wszDestination);

like seven includes, bestie. SEVEN. she's high maintenance but she's worth it πŸŽ€


πŸ’œ DESCRIPTION πŸ’œ

okay so Tspi_Context_Connect creates a connetion β€” yes the original says "connetion", I am not fixing her typo, she's iconic for it β€” between the application and the local or remote TSS System. that's it. that's the vibe. you got an app, you got a TSS System, and this function is the little matchmaker that introduces them 🫢

local or remote? your call, she's flexible πŸ’…


🌈 PARAMETERS 🌈

πŸ“ hLocalContext

the handle to the context to be connected. that's your girl. the context. she needs a handle and this is it πŸ’–

🧚 wszDestination

a null terminated unicode string which specifies the local or remote system to which one will be connected ✨

and listen, this part matters: if wszDestination is NULL, the connection will be to a local TCS. no destination, no problem, she just stays home 🏠

πŸ”₯ RETURN CODES πŸ”₯

Tspi_Context_Connect returns TSS_SUCCESS on success, otherwise one of the following values are returned:

  • TSS_E_INVALID_HANDLE β€” hLocalContext is an invalid handle. bestie. that handle is not real. she cannot work with that 😭
  • TSS_E_INTERNAL_ERROR β€” An error occurred internal to the TSS. not your fault, not her fault, it's the TSS's fault. we don't talk about it πŸ’€

πŸ‘‘ CONFORMING TO πŸ‘‘

Tspi_Context_Connect conforms to the Trusted Computing Group Software Specification version 1.1 Golden β€” golden!! like her ✨⭐


πŸŽ€ SEE ALSO πŸŽ€

(create her, connect her, close her. the full character arc, iykyk πŸ¦‹)


TSS 1.1 Β· dated 2004-05-26 β€” yeah she's an elder icon, been serving since 2004 and still ate, no cap πŸ’…πŸ‘‘

okay bye bestie, go connect something πŸ’–πŸŒˆβœ¨