NCryptEnumStorageProviders-Funktion (ncrypt.h)

Artikel
08/25/2023

Die NCryptEnumStorageProviders-Funktion ruft die Namen der registrierten Schlüsselspeicheranbieter ab.

Syntax

SECURITY_STATUS NCryptEnumStorageProviders(
  [out] DWORD              *pdwProviderCount,
  [out] NCryptProviderName **ppProviderList,
  [in]  DWORD              dwFlags
);

Parameter

[out] pdwProviderCount

Die Adresse eines DWORD-Elements , das die Anzahl der Elemente im ppProviderList-Array empfangen soll.

[out] ppProviderList

Die Adresse eines NCryptProviderName-Strukturzeigers zum Empfangen eines Arrays der registrierten Schlüsselspeicheranbieternamen. Die Variable, auf die der pdwProviderCount-Parameter verweist, empfängt die Anzahl der Elemente in diesem Array.

Wenn dieser Speicher nicht mehr benötigt wird, geben Sie ihn frei, indem Sie diesen Zeiger an die NCryptFreeBuffer-Funktion übergeben.

[in] dwFlags

Flags, die das Funktionsverhalten ändern. Dies kann null (0) oder der folgende Wert sein.

Wert	Bedeutung
NCRYPT_SILENT_FLAG	Fordert an, dass der Schlüsseldienstanbieter (Key Service Provider, KSP) keine Benutzeroberfläche anzeigt. Wenn der Anbieter die Benutzeroberfläche für den Betrieb anzeigen muss, schlägt der Aufruf fehl, und der KSP sollte den NTE_SILENT_CONTEXT Fehlercode als letzten Fehler festlegen.

Rückgabewert

Gibt einen status Code zurück, der den Erfolg oder Fehler der Funktion angibt.

Mögliche Rückgabecodes sind u. a. die folgenden:

Rückgabecode	Beschreibung
ERROR_SUCCESS	Die Funktion war erfolgreich.
NTE_BAD_FLAGS	Der dwFlags-Parameter enthält einen ungültigen Wert.
NTE_INVALID_PARAMETER	Mindestens ein Parameter ist ungültig.
NTE_NO_MEMORY	Ein Speicherbelegungsfehler ist aufgetreten.

Hinweise

Ein Dienst darf diese Funktion nicht über seine StartService-Funktion aufrufen. Wenn ein Dienst diese Funktion über seine StartService-Funktion aufruft, kann ein Deadlock auftreten, und der Dienst reagiert möglicherweise nicht mehr.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ncrypt.h
Bibliothek	Ncrypt.lib
DLL	Ncrypt.dll

Weitere Informationen

NCryptFreeBuffer

Freigeben über