Freigeben über


ExportSecurityContext-Funktion (sspi.h)

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