Freigeben über

ImportSecurityContextA-Funktion (sspi.h)

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

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 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

  • Last updated on