Tbsi_Context_Create-Funktion (tbs.h)

  • Artikel

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