ExportSecurityContext-Funktion (sspi.h)

Artikel
03/06/2024

Die ExportSecurityContext-Funktion erstellt eine serialisierte Darstellung eines Sicherheitskontexts , der später durch Aufrufen von in einen anderen Prozess importiert werden kann.
ImportSecurityContext. Der Prozess, der den Sicherheitskontext importiert, muss auf demselben Computer wie der Prozess ausgeführt werden, der ExportSecurityContext aufgerufen hat.

Syntax

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY ExportSecurityContext(
  [in]            PCtxtHandle phContext,
  [in]            ULONG       fFlags,
  [out]           PSecBuffer  pPackedContext,
  [out, optional] void        **pToken
);

Parameter

[in] phContext

Ein Handle des zu exportierenden Sicherheitskontexts.

[in] fFlags

Dieser Parameter kann eine bitweise OR-Kombination der folgenden Werte sein.

Wert	Bedeutung
SECPKG_CONTEXT_EXPORT_RESET_NEW 1 (0x1)	Der neue Sicherheitskontext wird auf seinen Ursprünglichen Zustand zurückgesetzt.
SECPKG_CONTEXT_EXPORT_DELETE_OLD 2 (0x2)	Der alte Sicherheitskontext wird gelöscht.
SECPKG_CONTEXT_EXPORT_TO_KERNEL 4 (0x4)	Dieser Wert wird nicht unterstützt. Windows Server 2003 und Windows XP/2000: Der Sicherheitskontext soll in den Kernel exportiert werden. Dieser Wert wird nur im Schannel-Kernelmodus unterstützt.

[out] pPackedContext

Ein Zeiger auf einen Puffer vom Typ SECBUFFER_EMPTY , der den serialisierten Sicherheitskontext empfängt . Wenn Sie mit der Verwendung dieses Kontexts fertig sind, geben Sie ihn frei, indem Sie die FreeContextBuffer-Funktion aufrufen.

[out, optional] pToken

Ein Zeiger zum Empfangen des Handles des Kontexttokens.

Wenn Sie die Verwendung des Benutzertokens abgeschlossen haben, geben Sie das Handle durch Aufrufen der CloseHandle-Funktion frei.

Rückgabewert

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

Wenn die Funktion fehlschlägt, gibt sie einen der folgenden Fehlercodes zurück.

Rückgabecode	Beschreibung
SEC_E_INSUFFICIENT_MEMORY	Es ist nicht genügend Arbeitsspeicher verfügbar, um die angeforderte Aktion abzuschließen.
SEC_E_INVALID_HANDLE	Der parameter phContext verweist nicht auf ein gültiges Handle.
SEC_E_NOT_SUPPORTED	Der Schannel-Kernelmodus unterstützt diese Funktion nicht.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	sspi.h (einschließlich Security.h)
Bibliothek	Secur32.lib
DLL	Secur32.dll

Weitere Informationen

FreeContextBuffer

ImportSecurityContext

SSPI-Funktionen

Freigeben über