Tbsi_Context_Create-Funktion (tbs.h)

Artikel
03/04/2024

Erstellt ein Kontexthandle, mit dem Befehle an TBS übergeben werden können.

Syntax

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

Parameter

[in] pContextParams

Ein Parameter für eine TBS_CONTEXT_PARAMS-Struktur , die die dem Kontext zugeordneten Parameter enthält.

[out] phContext

Ein Zeiger auf einen Speicherort zum Speichern des neuen Kontexthandles.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion TBS_SUCCESS zurück.

Wenn die Funktion fehlschlägt, gibt sie einen TBS-Rückgabecode zurück, der den Fehler angibt.

Rückgabecode/-wert	BESCHREIBUNG
TBS_SUCCESS 0 (0x0)	Die Funktion war erfolgreich.
TBS_E_BAD_PARAMETER 2150121474 (0x80284002)	Mindestens ein Parameterwert ist ungültig.
TBS_E_INTERNAL_ERROR 2150121473 (0x80284001)	Interner Softwarefehler.
TBS_E_INVALID_CONTEXT_PARAM 2150121479 (0x80284007)	Beim Erstellen eines TBS-Kontexts wurde ein ungültiger Kontextparameter übergeben.
TBS_E_INVALID_OUTPUT_POINTER 2150121475 (0x80284003)	Ein angegebener Ausgabezeiger ist ungültig.
TBS_E_SERVICE_DISABLED 2150121488 (0x80284010)	Der TBS-Dienst wurde deaktiviert.
TBS_E_SERVICE_NOT_RUNNING 2150121480 (0x80284008)	Der TBS-Dienst wird nicht ausgeführt und konnte nicht gestartet werden.
TBS_E_SERVICE_START_PENDING 2150121483 (0x8028400B)	Der TBS-Dienst wurde gestartet, wird aber noch nicht ausgeführt.
TBS_E_TOO_MANY_TBS_CONTEXTS 2150121481 (0x80284009)	Ein neuer Kontext konnte nicht erstellt werden, da zu viele offene Kontexte vorhanden sind.
TBS_E_TPM_NOT_FOUND 2150121487 (0x8028400F)	Auf diesem Computer kann kein kompatibles TPM-Sicherheitsgerät (Trusted Platform Module) gefunden werden.

Hinweise

Die TBS_CONTEXT_PARAMS-Struktur kann bereitgestellt werden, wobei das Versionsfeld auf TPM_VERSION_12 festgelegt ist. Anwendungen, die mit version 2.0 TPM interagieren, übergeben einen Zeiger auf eine TBS_CONTEXT_PARAMS2-Struktur , wobei das Versionsfeld auf TPM_VERSION_20 festgelegt ist. Legen Sie das reservierte Feld auf 0 und das IncludeTPm20-Feld auf 1 fest. Wenn die Anwendung bereit ist, auch mit einem TPM der Version 1.2 zu interagieren (falls das System kein TPM der Version 2.0 aufweist), legen Sie das Feld includeTpm12 auf 1 fest.

Wenn auf dem System kein TPM vorhanden ist oder die TPM-Version nicht mit den vom Aufrufer angeforderten übereinstimmt, gibt Tbsi_Context_Create den fehlercode TBS_E_TPM_NOT_FOUND (0x8028400) zurück. Anwendungsprogramme müssen beide Versionen überprüfen und mit beiden TPM interagieren können.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	tbs.h
Bibliothek	Tbs.lib
DLL	Tbs.dll

Freigeben über