EnumerateSecurityPackagesA-Funktion (sspi.h)
Die EnumerateSecurityPackages--Funktion gibt ein Array von SecPkgInfo- Strukturen zurück, die Informationen zu den Sicherheitspaketen bereitstellen, die für den Client verfügbar.
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 schließt Pakete ein, 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 Sicherheitssupportanbieter (SSP), der die Funktionen des sicherheitspakets beschreibt, das innerhalb dieses SSP verfügbar ist.
Wenn Sie die Verwendung des Arrays abgeschlossen haben, geben Sie den Speicher frei, indem Sie die FreeContextBuffer--Funktion aufrufen.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt die Funktion SEC_E_OKzurück.
Wenn die Funktion fehlschlägt, wird ein Fehlercode ungleich Null zurückgegeben. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.
| Zurückgeben von Code/Wert | Beschreibung |
|---|---|
|
Es war nicht genügend Arbeitsspeicher vorhanden, um einen oder mehrere Puffer zuzuweisen. |
|
Es wurde ein ungültiger Handle angegeben. |
|
Das angegebene Paket wurde nicht gefunden. |
Bemerkungen
Der Aufrufer kann den Name Member einer SecPkgInfo- Struktur verwenden, um ein Sicherheitspaket in einem Aufruf der AcquireCredentialsHandle (General)-Funktion anzugeben.
Anmerkung
Der header sspi.h 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 |
|---|---|
| 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- | SspiCli.dll |