funzione Tbsi_Context_Create (tbs.h)

Articolo
03/05/2024

Crea un handle di contesto che può essere usato per passare i comandi a TBS.

Sintassi

TBS_RESULT Tbsi_Context_Create(
  [in]  PCTBS_CONTEXT_PARAMS pContextParams,
  [out] PTBS_HCONTEXT        phContext
);

Parametri

[in] pContextParams

Parametro di una struttura TBS_CONTEXT_PARAMS che contiene i parametri associati al contesto.

[out] phContext

Puntatore a una posizione in cui archiviare il nuovo handle di contesto.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce TBS_SUCCESS.

Se la funzione ha esito negativo, restituisce un codice restituito TBS che indica l'errore.

Codice/valore restituito	Descrizione
TBS_SUCCESS 0 (0x0)	La funzione ha avuto esito positivo.
TBS_E_BAD_PARAMETER 2150121474 (0x80284002)	Uno o più valori di parametro non sono validi.
TBS_E_INTERNAL_ERROR 2150121473 (0x80284001)	Si è verificato un errore interno del software.
TBS_E_INVALID_CONTEXT_PARAM 2150121479 (0x80284007)	È stato passato un parametro di contesto non valido quando si tenta di creare un contesto TBS.
TBS_E_INVALID_OUTPUT_POINTER 2150121475 (0x80284003)	Un puntatore di output specificato non è valido.
TBS_E_SERVICE_DISABLED 2150121488 (0x80284010)	Il servizio TBS è stato disabilitato.
TBS_E_SERVICE_NOT_RUNNING 2150121480 (0x80284008)	Il servizio TBS non è in esecuzione e non è stato possibile avviare.
TBS_E_SERVICE_START_PENDING 2150121483 (0x8028400B)	Il servizio TBS è stato avviato ma non è ancora in esecuzione.
TBS_E_TOO_MANY_TBS_CONTEXTS 2150121481 (0x80284009)	Non è stato possibile creare un nuovo contesto perché sono presenti troppi contesti aperti.
TBS_E_TPM_NOT_FOUND 2150121487 (0x8028400F)	Non è possibile trovare un dispositivo di sicurezza TPM (Trusted Platform Module) compatibile in questo computer.

Commenti

È possibile specificare la struttura TBS_CONTEXT_PARAMS, con il campo versione impostato su TPM_VERSION_12. Le applicazioni che interagiscono con la versione 2.0 TPM passeranno un puntatore a una struttura TBS_CONTEXT_PARAMS2 , con il campo della versione impostato su TPM_VERSION_20. Impostare il campo riservato su 0 e il campo includeTPm20 su 1. Se l'applicazione è pronta per interagire con un TPM versione 1.2 (nel caso in cui il sistema non abbia una versione 2.0 TPM), impostare il campo includeTpm12 su 1.

Se nel sistema non è presente alcun TPM o la versione TPM non corrisponde a quelle richieste dal chiamante, Tbsi_Context_Create restituirà il codice di errore TBS_E_TPM_NOT_FOUND (0x8028400). I programmi dell'applicazione devono verificare la presenza di entrambe le versioni e poter interagire con entrambi I TPM.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	tbs.h
Libreria	Tbs.lib
DLL	Tbs.dll

Condividi tramite