ImportSecurityContextA-Funktion (sspi.h)
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 |
|---|---|
|
Die für das Paket angegebenen Anmeldeinformationen wurden nicht erkannt. |
|
Im Sicherheitspaket sind keine Anmeldeinformationen verfügbar. |
|
Der Aufrufer der Funktion verfügt nicht über die erforderlichen Anmeldeinformationen. |
|
Es ist nicht genügend Arbeitsspeicher verfügbar, um die angeforderte Aktion abzuschließen. |
|
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 |