EnumerateSecurityPackagesA-Funktion (sspi.h)

Die EnumerateSecurityPackages-Funktion gibt ein Array von SecPkgInfo-Strukturen zurück, die Informationen zu den für den Client verfügbaren Sicherheitspaketen bereitstellen.

Syntax

SECURITY_STATUS SEC_ENTRY EnumerateSecurityPackagesA(
  [in] unsigned long *pcPackages,
  [in] PSecPkgInfoA  *ppPackageInfo
);

Parameter

[in] pcPackages

Ein Zeiger auf eine ULONG-Variable , die die Anzahl der im System verfügbaren Pakete empfängt. Dies umfasst Pakete, die bereits geladen sind, und Pakete, die bei Bedarf verfügbar sind.

[in] ppPackageInfo

Ein Zeiger auf eine Variable, die einen Zeiger auf ein Array von SecPkgInfo-Strukturen empfängt. Jede Struktur enthält Informationen vom Sicherheitsunterstützungsanbieter (Security Support Provider , SSP), die die Funktionen des in diesem SSP verfügbaren Sicherheitspakets beschreiben.

Wenn Sie die Verwendung des Arrays abgeschlossen haben, geben Sie den Arbeitsspeicher frei, indem Sie die FreeContextBuffer-Funktion aufrufen.

Rückgabewert

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

Wenn die Funktion fehlschlägt, wird ein Fehlercode ungleich null zurückgegeben. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode/-wert	BESCHREIBUNG
SEC_E_INSUFFICIENT_MEMORY 0x80090300L	Es war nicht genügend Arbeitsspeicher vorhanden, um einen oder mehrere der Puffer zuzuweisen.
SEC_E_INVALID_HANDLE 0x80090301L	Es wurde ein ungültiges Handle angegeben.
SEC_E_SECPKG_NOT_FOUND 0x80090305L	Das angegebene Paket wurde nicht gefunden.

Hinweise

Der Aufrufer kann den Member Name einer SecPkgInfo-Struktur verwenden, um ein Sicherheitspaket in einem Aufruf der AcquireCredentialsHandle-Funktion (Allgemein) anzugeben.

Hinweis

Der sspi.h-Header definiert EnumerateSecurityPackages 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	SspiCli.dll

Weitere Informationen

AcquireCredentialsHandle (Allgemein)

FreeContextBuffer

SSPI-Funktionen

SecPkgInfo