Funzione NCryptOpenStorageProvider (ncrypt.h)

Articolo
08/25/2023

La funzione NCryptOpenStorageProvider carica e inizializza un provider di archiviazione chiavi CNG.

Sintassi

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

Parametri

[out] phProvider

Puntatore a una variabile NCRYPT_PROV_HANDLE che riceve l'handle del provider. Al termine dell'uso di questo handle, rilasciarlo passandolo alla funzione NCryptFreeObject .

[in, optional] pszProviderName

Puntatore a una stringa Unicode con terminazione null che identifica il provider di archiviazione delle chiavi da caricare. Si tratta dell'alias registrato del provider di archiviazione delle chiavi. Questo parametro è facoltativo e può essere NULL. Se questo parametro è NULL, viene caricato il provider di archiviazione delle chiavi predefinito. I valori seguenti identificano i provider di archiviazione delle chiavi predefiniti.

Valore	Significato
MS_KEY_STORAGE_PROVIDER L"Provider di archiviazione chiavi software Microsoft"	Identifica il provider di archiviazione delle chiavi software fornito da Microsoft.
MS_SMART_CARD_KEY_STORAGE_PROVIDER L"Provider di archiviazione chiavi smart card Microsoft"	Identifica il provider di archiviazione delle chiavi smart card fornito da Microsoft.
MS_PLATFORM_CRYPTO_PROVIDER L"Microsoft Platform Crypto Provider"	Identifica il provider di archiviazione delle chiavi TPM fornito da Microsoft.

[in] dwFlags

Contrassegni che modificano il comportamento della funzione. Per questa funzione non sono definiti flag.

Valore restituito

Restituisce un codice di stato che indica l'esito positivo o negativo della funzione.

I codici restituiti possibili includono, ma non sono limitati a, i seguenti.

Codice restituito	Descrizione
ERROR_SUCCESS	La funzione ha avuto esito positivo.
NTE_BAD_FLAGS	Il parametro dwFlags contiene uno o più flag non supportati.
NTE_INVALID_PARAMETER	Uno o più parametri non sono validi.
NTE_NO_MEMORY	Si è verificato un errore di allocazione della memoria.

Commenti

Nel caso in cui venga restituita una condizione di errore, il provider verrà scaricato dalla memoria. Le funzioni all'interno del provider non devono essere chiamate dopo che viene restituito un errore di errore.

Un servizio non deve chiamare questa funzione dalla funzione StartService. Se un servizio chiama questa funzione dalla funzione StartService, può verificarsi un deadlock e il servizio potrebbe interrompere la risposta.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	ncrypt.h
Libreria	Ncrypt.lib
DLL	Ncrypt.dll

Condividi tramite