Funzione CryptSetProviderExA (wincrypt.h)

Articolo
08/27/2023

Importante Questa API è deprecata. Il software nuovo ed esistente deve iniziare a usare le API cryptography next generation. Microsoft potrebbe rimuovere questa API nelle versioni future.

La funzione CryptSetProviderEx specifica il provider di servizi di crittografia predefinito (CSP) di un tipo di provider specificato per il computer locale o l'utente corrente.

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

Sintassi

BOOL CryptSetProviderExA(
  [in] LPCSTR pszProvName,
  [in] DWORD  dwProvType,
  [in] DWORD  *pdwReserved,
  [in] DWORD  dwFlags
);

Parametri

[in] pszProvName

Nome del nuovo provider di servizi di configurazione predefinito. Deve trattarsi di un provider di servizi di configurazione installato nel computer. Per un elenco dei provider di crittografia disponibili, vedere Cryptographic Provider Names.For a list of available cryptographic providers providers, see Cryptographic Provider Names.

[in] dwProvType

Tipo di provider del provider specificato da pszProvName.

[in] pdwReserved

Questo parametro è riservato per uso futuro e deve essere NULL.

[in] dwFlags

Vengono definiti i valori del flag seguenti.

Valore	Significato
CRYPT_DELETE_DEFAULT 0x00000004	Può essere usato in combinazione con CRYPT_MACHINE_DEFAULT o CRYPT_USER_DEFAULT per eliminare il valore predefinito.
CRYPT_USER_DEFAULT 0x00000002	Determina l'impostazione del CSP predefinito del contesto utente del tipo specificato.
CRYPT_MACHINE_DEFAULT 0x00000001	Determina l'impostazione del provider di servizi di configurazione predefinito del computer del tipo specificato.

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. I codici di errore possibili includono quelli illustrati nella tabella seguente.

Codice restituito	Descrizione
ERROR_INVALID_PARAMETER	Uno dei parametri contiene un valore non valido. Si tratta più spesso di un puntatore che non è valido.
ERROR_NOT_ENOUGH_MEMORY	Memoria insufficiente del sistema operativo.

Commenti

La maggior parte delle applicazioni non specifica un nome CSP quando si chiama la funzione CryptAcquireContext ; Tuttavia, un'applicazione può specificare un nome CSP e quindi selezionare un provider di servizi di configurazione con un livello di sicurezza appropriato. Poiché le chiamate a CryptSetProviderEx determinano il CSP di un tipo specificato usato da tutte le applicazioni da quel punto in poi, CryptSetProviderEx non deve mai essere chiamato senza il consenso di un utente.

Nota

L'intestazione wincrypt.h definisce CryptSetProviderEx 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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

Vedi anche

Cryptacquirecontext

CryptSetProvider

Funzioni del provider di servizi

Condividi tramite