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 |
|---|---|
|
Es war nicht genügend Arbeitsspeicher vorhanden, um einen oder mehrere der Puffer zuzuweisen. |
|
Es wurde ein ungültiges Handle angegeben. |
|
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 |