NCryptIsAlgSupported-Funktion (ncrypt.h)

Artikel
03/04/2024

Die NCryptIsAlgSupported-Funktion bestimmt, ob ein CNG-Schlüsselspeicheranbieter einen bestimmten kryptografischen Algorithmus unterstützt.

Syntax

SECURITY_STATUS NCryptIsAlgSupported(
  [in] NCRYPT_PROV_HANDLE hProvider,
  [in] LPCWSTR            pszAlgId,
  [in] DWORD              dwFlags
);

Parameter

[in] hProvider

Das Handle des Schlüsselspeicheranbieters. Dieses Handle wird mit der Funktion NCryptOpenStorageProvider abgerufen.

[in] pszAlgId

Ein Zeiger auf eine unicode-Zeichenfolge mit NULL-Beendigung, die den betreffenden kryptografischen Algorithmus identifiziert. Dies kann einer der Standard-CNG-Algorithmusbezeichner oder der Bezeichner für einen anderen registrierten Algorithmus sein.

[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 anzeigen muss, um zu funktionieren, 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 umfassen folgendes, sind aber nicht darauf beschränkt.

Rückgabecode	Beschreibung
ERROR_SUCCESS	Der Anbieter unterstützt den angegebenen Algorithmus.
NTE_BAD_FLAGS	Der dwFlags-Parameter enthält mindestens ein Flag, das nicht unterstützt wird.
NTE_INVALID_HANDLE	Das vom hProvider-Parameter angegebene Handle ist ungültig.
NTE_INVALID_PARAMETER	Mindestens ein Parameter ist ungültig.
NTE_NOT_SUPPORTED	Der Anbieter unterstützt den angegebenen Algorithmus nicht.

Hinweise

Wenn der Anbieter den Algorithmus unterstützt, gibt diese Funktion ERROR_SUCCESS zurück. Wenn der Anbieter den Algorithmus nicht unterstützt und keine anderen Fehler aufgetreten sind, gibt diese Funktion NTE_NOT_SUPPORTED zurück.

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 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	ncrypt.h
Bibliothek	Ncrypt.lib
DLL	Ncrypt.dll

Freigeben über