Funzione CryptSetProviderA (wincrypt.h)
Se il provider predefinito di un utente corrente è impostato, tale provider predefinito viene acquisito da qualsiasi chiamata da tale utente a CryptAcquireContext specificando un tipo di provider dwProvType ma non un nome CSP.
È disponibile anche una versione avanzata di questa funzione, CryptSetProviderEx.
Sintassi
BOOL CryptSetProviderA(
[in] LPCSTR pszProvName,
[in] DWORD dwProvType
);
Parametri
[in] pszProvName
Nome del nuovo CSP predefinito. Il CSP denominato deve essere installato nel computer. Per un elenco dei provider di crittografia disponibili, vedere Nomi provider crittografici.
[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 sull'errore estese, chiamare GetLastError. Alcuni codici di errore possibili sono elencati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Uno dei parametri specifica un handle non valido. |
|
Uno dei parametri contiene un valore non valido. Questo è più spesso un puntatore che non è valido. |
|
Il sistema operativo ha esaurito la memoria durante l'operazione. |
Gli errori possono essere propagati anche dalle chiamate interne a RegCreateKeyEx e RegSetValueEx.
Commenti
Le applicazioni tipiche non specificano un nome CSP quando si chiama CryptAcquireContext; Tuttavia, un'applicazione ha la possibilità di selezionare un CSP specifico. Ciò consente a un utente di selezionare un CSP con un livello di sicurezza appropriato.
Poiché la chiamata a CryptSetProvider determina il CSP di un tipo specificato usato da tutte le applicazioni eseguite da quel punto, 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | wincrypt.h |
| Libreria | Advapi32.lib |
| DLL | Advapi32.dll |