NCryptOpenStorageProvider-Funktion (ncrypt.h)

  • Artikel

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