ImportSecurityContextA-Funktion (sspi.h)

  • Artikel

Die ImportSecurityContext-Funktion importiert einen Sicherheitskontext. Der Sicherheitskontext muss durch einen vorherigen Aufruf von ExportSecurityContext in den Prozess exportiert worden sein, der ImportSecurityContext aufruft.

Syntax

SECURITY_STATUS SEC_ENTRY ImportSecurityContextA(
  [in]           LPSTR       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 Sicherheitskontext exportiert wurde.

[in] pPackedContext

Ein Zeiger auf einen Puffer, der den von ExportSecurityContext erstellten serialisierten Sicherheitskontext enthält.

[in, optional] Token

Ein Handle für das Token des Kontexts.

[out] phContext

Ein Handle des neuen Sicherheitskontexts, der aus pPackedContext erstellt wurde. Wenn Sie die Verwendung des Kontexts abgeschlossen 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, gibt sie einen der folgenden Fehlercodes zurück.

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

Hinweise

Hinweis

Der sspi.h-Header 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
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

ExportSecurityContext

FreeContextBuffer

SSPI-Funktionen