Funzione CryptSetProviderExA (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 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 essere un provider di servizi di configurazione 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.

[in] pdwReserved

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

[in] dwFlags

Vengono definiti i valori di flag seguenti.

Valore	Significato
CRYPT_DELETE_DEFAULT 0x00000004	Può essere usato insieme a CRYPT_MACHINE_DEFAULT o CRYPT_USER_DEFAULT per eliminare il valore predefinito.
CRYPT_USER_DEFAULT 0x00000002	Determina l'impostazione del provider di servizi di configurazione 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 non valido.
ERROR_NOT_ENOUGH_MEMORY	Memoria esaurita del sistema operativo.

Osservazioni

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 determinare il provider di servizi di configurazione di un tipo specificato usato da tutte le applicazioni da quel punto in poi, CryptSetProviderEx non devono mai essere chiamati 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 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

CryptSetProvider

funzioni del provider di servizi

Condividi tramite