Funzione CryptSetProviderA (wincrypt.h)

Articolo
11/20/2024

Importante Questa API è deprecata. Il software nuovo ed esistente deve iniziare a usare API Di nuova generazione di crittografia. Microsoft potrebbe rimuovere questa API nelle versioni future.

La funzione CryptSetProvider specifica l'provider di servizi di crittografia (CSP) predefinito dell'utente corrente.

Se il provider predefinito di un utente corrente è impostato, tale provider predefinito viene acquisito da qualsiasi chiamata da tale utente per CryptAcquireContext specificando un tipo di provider dwProvType ma non un nome CSP.

È disponibile anche una versione avanzata di questa funzione, CryptSetProviderEx.

Nota Le applicazioni tipiche non usano questa funzione. È destinato esclusivamente alle applicazioni amministrative.

Sintassi

BOOL CryptSetProviderA(
  [in] LPCSTR pszProvName,
  [in] DWORD  dwProvType
);

Parametri

[in] pszProvName

Nome del nuovo provider di servizi di configurazione predefinito. Il provider di servizi di configurazione denominato deve essere installato nel computer. Per un elenco dei provider di crittografia disponibili, vedere nomi dei provider di crittografia.

[in] dwProvType

Tipo di provider del provider specificato da pszProvName.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero (TRUE).

Se la funzione ha esito negativo, il valore restituito è zero (FALSE). Per informazioni sugli errori estesi, chiamare GetLastError. Nella tabella seguente sono elencati alcuni possibili codici di errore.

Codice restituito	Descrizione
ERROR_INVALID_HANDLE	Uno dei parametri specifica un handle non valido.
ERROR_INVALID_PARAMETER	Uno dei parametri contiene un valore non valido. Si tratta più spesso di un puntatore non valido.
ERROR_NOT_ENOUGH_MEMORY	Il sistema operativo ha esaurito la memoria durante l'operazione.

Gli errori possono anche essere propagati da chiamate interne a RegCreateKeyEx e RegSetValueEx.

Osservazioni

Le applicazioni tipiche non specificano un nome CSP quando si chiama CryptAcquireContext; Tuttavia, un'applicazione ha la possibilità di selezionare un provider di servizi di configurazione specifico. Ciò consente a un utente di selezionare un provider di servizi di configurazione con un livello di sicurezza appropriato.

Poiché la chiamata CryptSetProvider determina il provider di servizi di configurazione di un tipo specificato usato da tutte le applicazioni eseguite da quel punto in poi, questa funzione non deve essere chiamata senza il consenso degli utenti.

Nota

L'intestazione wincrypt.h definisce CryptSetProvider come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	wincrypt.h
libreria	Advapi32.lib
dll	Advapi32.dll

Vedere anche

CryptAcquireContext

i nomi dei provider di crittografia

RegCreateKeyEx

RegSetValueEx

funzioni del provider di servizi

Condividi tramite