Funzione CryptSetProviderExA (wincrypt.h)

  • Articolo
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