Função CryptInstallDefaultContext (wincrypt.h)
Sintaxe
BOOL CryptInstallDefaultContext(
[in] HCRYPTPROV hCryptProv,
[in] DWORD dwDefaultType,
[in] const void *pvDefaultPara,
[in] DWORD dwFlags,
[in] void *pvReserved,
[out] HCRYPTDEFAULTCONTEXT *phDefaultContext
);
Parâmetros
[in] hCryptProv
O identificador do provedor de serviços criptográficos a ser usado como o contexto padrão. Esse identificador é obtido usando a função CryptAcquireContext .
[in] dwDefaultType
Especifica o tipo de contexto a ser instalado. Esse deve ser um dos valores a seguir.
| Valor | Significado |
|---|---|
|
Instala o provedor padrão usado para verificar um único tipo de assinatura de certificado.
O parâmetro pvDefaultPara é o endereço de uma cadeia de caracteres ANSI terminada em nulo que contém o identificador de objeto do algoritmo de assinatura de certificado para instalar o provedor para, por exemplo, szOID_OIWSEC_md5RSA. Se o parâmetro pvDefaultPara for NULL, o provedor especificado será usado para verificar todas as assinaturas de certificado. O parâmetro pvDefaultPara não pode ser NULL quando o sinalizador CRYPT_DEFAULT_CONTEXT_PROCESS_FLAG é definido. |
|
Instala o provedor padrão usado para verificar vários tipos de assinatura de certificado.
O parâmetro pvDefaultPara é o endereço de uma estrutura CRYPT_DEFAULT_CONTEXT_MULTI_OID_PARA que contém uma matriz de identificadores de objeto que identificam os algoritmos de assinatura de certificado para o qual instalar o provedor especificado. |
[in] pvDefaultPara
Especifica o objeto ou os objetos para os quais instalar o provedor de contexto padrão. O formato desse parâmetro depende do conteúdo do parâmetro dwDefaultType .
[in] dwFlags
Um conjunto de sinalizadores que modificam o comportamento dessa função. Isso pode ser zero ou uma combinação de um ou mais dos valores a seguir.
| Valor | Significado |
|---|---|
|
O identificador do provedor especificado pelo parâmetro hCryptProv é liberado automaticamente quando o processo ou thread termina. Se esse sinalizador não for especificado, será responsabilidade do chamador liberar o identificador do provedor usando a função CryptReleaseContext quando o identificador não for mais necessário. O identificador do provedor não será liberado se a função CryptUninstallDefaultContext for chamada antes da saída do processo ou do thread. |
|
O provedor se aplica a todos os threads no processo. Se esse sinalizador não for especificado, o provedor só se aplicará ao thread de chamada. O parâmetro pvDefaultPara não pode ser NULL quando esse sinalizador é definido. |
[in] pvReserved
Esse parâmetro é reservado para uso futuro.
[out] phDefaultContext
O endereço de uma variável HCRYPTDEFAULTCONTEXT que recebe o identificador de contexto padrão. Esse identificador é passado para a função CryptUninstallDefaultContext para desinstalar o provedor de contexto padrão.
Retornar valor
Se a função for bem-sucedida, o valor retornado será diferente de zero (TRUE). Se a função falhar, o valor retornado será zero (FALSE). Para obter informações de erro estendidas, chame GetLastError.
Comentários
Os provedores de contexto padrão instalados são ordenados por pilha, portanto, ao pesquisar um provedor de contexto padrão, o sistema começa com o provedor instalado mais recentemente. A lista por thread de provedores é pesquisada antes da lista por processo de provedores. Depois que uma correspondência é encontrada, o sistema não continua a pesquisar outras correspondências.
O identificador do provedor instalado deve permanecer disponível para uso até que CryptUninstallDefaultContext seja chamado ou o thread ou o processo seja encerrado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | wincrypt.h |
| Biblioteca | Crypt32.lib |
| DLL | Crypt32.dll |