Função CryptSetProviderExA (wincrypt.h)

Artigo
11/20/2024

Importante essa API foi preterida. O software novo e existente deve começar a usar APIs de Próxima Geração da Criptografia. Microsoft pode remover essa API em versões futuras.

A função CryptSetProviderEx especifica o padrão CSP ( provedor de serviços criptográficos) de um tipo de provedor especificado para o computador local ou o usuário atual.

Observação Aplicativos típicos não usam essa função. Ele destina-se a ser usado exclusivamente por aplicativos administrativos.

Sintaxe

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

Parâmetros

[in] pszProvName

O nome do novo CSP padrão. Este deve ser um CSP instalado no computador. Para obter uma lista de provedores criptográficos disponíveis, consulte nomes de provedor criptográfico.

[in] dwProvType

O tipo de provedor do CSP especificado por pszProvName.

[in] pdwReserved

Esse parâmetro é reservado para uso futuro e deve ser NULL.

[in] dwFlags

Os valores de sinalizador a seguir são definidos.

Valor	Significado
CRYPT_DELETE_DEFAULT 0x00000004	Pode ser usado em conjunto com CRYPT_MACHINE_DEFAULT ou CRYPT_USER_DEFAULT para excluir o padrão.
CRYPT_USER_DEFAULT 0x00000002	Faz com que o CSP padrão de contexto do usuário do tipo especificado seja definido.
CRYPT_MACHINE_DEFAULT 0x00000001	Faz com que o CSP padrão do computador do tipo especificado seja definido.

Valor de retorno

Se a função for bem-sucedida, o valor retornado não será zero (TRUE).

Se a função falhar, o valor retornado será zero (false). Para obter informações de erro estendidas, chame GetLastError. Os códigos de erro possíveis incluem os mostrados na tabela a seguir.

Código de retorno	Descrição
ERROR_INVALID_PARAMETER	Um dos parâmetros contém um valor que não é válido. Isso geralmente é um ponteiro que não é válido.
ERROR_NOT_ENOUGH_MEMORY	O sistema operacional ficou sem memória.

Observações

A maioria dos aplicativos não especifica um nome CSP ao chamar a função CryptAcquireContext; no entanto, um aplicativo pode especificar um nome CSP e, assim, selecionar um CSP com um nível apropriado de segurança. Como as chamadas para CryptSetProviderEx determinar o CSP de um tipo especificado usado por todos os aplicativos desse ponto em diante, CryptSetProviderEx nunca deve ser chamado sem o consentimento de um usuário.

Nota

O cabeçalho wincrypt.h define CryptSetProviderEx como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	wincrypt.h
biblioteca	Advapi32.lib
de DLL	Advapi32.dll

Consulte também

CryptAcquireContext

CryptSetProvider

Funções do provedor de serviços

Compartilhar via