ImportSecurityContextW-Funktion (sspi.h)

Artikel
11/20/2024

Die ImportSecurityContext-funktion importiert einen Sicherheitskontext. Der Sicherheitskontext muss in den Prozessaufruf ImportSecurityContext durch einen vorherigen Aufruf von ExportSecurityContextexportiert worden sein.

Syntax

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY ImportSecurityContextW(
  [in]           PSECURITY_STRING pszPackage,
  [in]           PSecBuffer       pPackedContext,
  [in, optional] void             *Token,
  [out]          PCtxtHandle      phContext
);

Parameter

[in] pszPackage

Eine Zeichenfolge, die den Namen des Sicherheitspakets enthält, in das der Sicherheits kontext exportiert wurde.

[in] pPackedContext

Ein Zeiger auf einen Puffer, der den serialisierten serialisierten Sicherheitskontext enthält, der von ExportSecurityContexterstellt wurde.

[in, optional] Token

Ein Handle für das Kontexttoken.

[out] phContext

Ein Handle des neuen Sicherheitskontexts, der aus pPackedContexterstellt wurde. Wenn Sie den Kontext verwendet haben, löschen Sie ihn, indem Sie die DeleteSecurityContext--Funktion aufrufen.

Rückgabewert

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

Wenn die Funktion fehlschlägt, wird eine der folgenden Fehlercodes zurückgegeben.

Rückgabecode	Beschreibung
SEC_E_UNKNOWN_CREDENTIALS	Die für das Paket bereitgestellten Anmeldeinformationen wurden nicht erkannt.
SEC_E_NO_CREDENTIALS	Im Sicherheitspaketsind keine Anmeldeinformationen verfügbar.
SEC_E_NOT_OWNER	Der Aufrufer der Funktion verfügt nicht über die erforderlichen Anmeldeinformationen.
SEC_E_INSUFFICIENT_MEMORY	Es steht nicht genügend Arbeitsspeicher zur Verfügung, um die angeforderte Aktion abzuschließen.
SEC_E_INTERNAL_ERROR	Ein Fehler ist aufgetreten, der keinem SSPI-Fehlercode zugeordnet wurde.

Bemerkungen

Anmerkung

Der header sspi.h definiert ImportSecurityContext als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	sspi.h (include Security.h)
Library	Secur32.lib
DLL-	Secur32.dll

Siehe auch

ExportSecurityContext-

FreeContextBuffer

SSPI-Funktionen

Freigeben über