NCryptOpenStorageProvider-Funktion (ncrypt.h)

Artikel
02/29/2024

Die NCryptOpenStorageProvider-Funktion lädt und initialisiert einen CNG-Schlüsselspeicheranbieter.

Syntax

SECURITY_STATUS NCryptOpenStorageProvider(
  [out]          NCRYPT_PROV_HANDLE *phProvider,
  [in, optional] LPCWSTR            pszProviderName,
  [in]           DWORD              dwFlags
);

Parameter

[out] phProvider

Ein Zeiger auf eine NCRYPT_PROV_HANDLE Variable, die das Anbieterhandle empfängt. Wenn Sie mit der Verwendung dieses Handle fertig sind, geben Sie es frei, indem Sie es an die NCryptFreeObject-Funktion übergeben.

[in, optional] pszProviderName

Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den zu ladenden Schlüsselspeicheranbieter identifiziert. Dies ist der registrierte Alias des Schlüsselspeicheranbieters. Dieser Parameter ist optional und kann NULL sein. Wenn dieser Parameter NULL ist, wird der Standardschlüsselspeicheranbieter geladen. Die folgenden Werte identifizieren die integrierten Schlüsselspeicheranbieter.

Wert	Bedeutung
MS_KEY_STORAGE_PROVIDER L"Microsoft Software Key Storage Provider"	Gibt den Von Microsoft bereitgestellten Softwareschlüsselspeicheranbieter an.
MS_SMART_CARD_KEY_STORAGE_PROVIDER L "Microsoft SmartCard Key Storage Provider"	Gibt den smarten Karte Schlüsselspeicheranbieter an, der von Microsoft bereitgestellt wird.
MS_PLATFORM_CRYPTO_PROVIDER L"Microsoft Platform Crypto Provider"	Gibt den TPM-Schlüsselspeicheranbieter an, der von Microsoft bereitgestellt wird.

[in] dwFlags

Flags, die das Verhalten der Funktion ändern. Für diese Funktion sind keine Flags definiert.

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	Die Funktion war erfolgreich.
NTE_BAD_FLAGS	Der dwFlags-Parameter enthält mindestens ein Flag, das nicht unterstützt wird.
NTE_INVALID_PARAMETER	Mindestens ein Parameter ist ungültig.
NTE_NO_MEMORY	Ein Fehler bei der Speicherzuordnung ist aufgetreten.

Hinweise

Falls eine Fehlerbedingung zurückgegeben wird, wurde der Anbieter aus dem Arbeitsspeicher entladen. Funktionen innerhalb des Anbieters dürfen nicht aufgerufen werden, nachdem ein Fehlerfehler zurückgegeben wurde.

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