Share via

Tbsip_Context_Close-Funktion (tbs.h)

  • Artikel

Schließt ein Kontexthandle, das Ressourcen freigibt, die dem Kontext in TBS zugeordnet sind, und schließt das Bindungshandle, das für die Kommunikation mit TBS verwendet wird.

Syntax

TBS_RESULT Tbsip_Context_Close(
  [in] TBS_HCONTEXT hContext
);

Parameter

[in] hContext

Ein Handle des zu schließenden Kontexts.

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_INTERNAL_ERROR
2150121473 (0x80284001)
 Interner Softwarefehler.
TBS_E_INVALID_CONTEXT
2150121476 (0x80284004)
 Das angegebene Kontexthandle verweist nicht auf einen gültigen Kontext.

Hinweise

Wenn das Kontexthandle geschlossen wird, wird die dem Kontexthandle zugeordnete Struktur auf null gesetzt, wodurch sichergestellt wird, dass nachfolgende Versuche, das Handle zu verwenden, zu einem Fehler führen. Alle Objekte, die unter diesem Kontext erstellt wurden, werden geleert.

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