Tbsi_Context_Create, fonction (tbs.h)

Article
03/04/2024

Crée un handle de contexte qui peut être utilisé pour passer des commandes à TBS.

Syntaxe

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

Paramètres

[in] pContextParams

Paramètre d’une structure TBS_CONTEXT_PARAMS qui contient les paramètres associés au contexte.

[out] phContext

Pointeur vers un emplacement pour stocker le nouveau handle de contexte.

Valeur retournée

Si la fonction réussit, la fonction retourne TBS_SUCCESS.

Si la fonction échoue, elle retourne un code de retour TBS qui indique l’erreur.

Code/valeur de retour	Description
TBS_SUCCESS 0 (0x0)	La fonction a réussi.
TBS_E_BAD_PARAMETER 2150121474 (0x80284002)	Une ou plusieurs valeurs de paramètre ne sont pas valides.
TBS_E_INTERNAL_ERROR 2150121473 (0x80284001)	Une erreur interne du logiciel s'est produite.
TBS_E_INVALID_CONTEXT_PARAM 2150121479 (0x80284007)	Un paramètre de contexte non valide a été passé lors de la tentative de création d’un contexte TBS.
TBS_E_INVALID_OUTPUT_POINTER 2150121475 (0x80284003)	Un pointeur de sortie spécifié n’est pas valide.
TBS_E_SERVICE_DISABLED 2150121488 (0x80284010)	Le service TBS a été désactivé.
TBS_E_SERVICE_NOT_RUNNING 2150121480 (0x80284008)	Le service TBS n’est pas en cours d’exécution et n’a pas pu être démarré.
TBS_E_SERVICE_START_PENDING 2150121483 (0x8028400B)	Le service TBS a été démarré mais n’est pas encore en cours d’exécution.
TBS_E_TOO_MANY_TBS_CONTEXTS 2150121481 (0x80284009)	Impossible de créer un nouveau contexte, car il y a trop de contextes ouverts.
TBS_E_TPM_NOT_FOUND 2150121487 (0x8028400F)	Impossible de trouver un périphérique de sécurité de module de plateforme sécurisée (TPM) compatible sur cet ordinateur.

Remarques

La structure TBS_CONTEXT_PARAMS peut être fournie, avec le champ version défini sur TPM_VERSION_12. Les applications qui interagissent avec le module TPM version 2.0 passent un pointeur vers une structure TBS_CONTEXT_PARAMS2 , avec le champ version défini sur TPM_VERSION_20. Définissez le champ réservé sur 0 et le champ includeTPm20 sur 1. Si l’application est également prête à interagir avec un module TPM version 1.2 (si le système n’a pas de TPM version 2.0), définissez le champ includeTpm12 sur 1.

Si aucun module de plateforme sécurisée n’est présent sur le système ou si la version du module de plateforme sécurisée ne correspond pas à celles demandées par l’appelant, Tbsi_Context_Create retournera le code d’erreur TBS_E_TPM_NOT_FOUND (0x8028400). Les programmes d’application doivent case activée pour les deux versions et être en mesure d’interagir avec l’une ou l’autre des versions TPM.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	tbs.h
Bibliothèque	Tbs.lib
DLL	Tbs.dll

Partager via