Função BCryptConfigureContextFunction (bcrypt.h)

  • Artigo

[BCryptConfigureContextFunction está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

A função BCryptConfigureContextFunction define as informações de configuração para a função criptográfica de um contexto CNG existente.

Sintaxe

NTSTATUS BCryptConfigureContextFunction(
  [in] ULONG                          dwTable,
  [in] LPCWSTR                        pszContext,
  [in] ULONG                          dwInterface,
  [in] LPCWSTR                        pszFunction,
  [in] PCRYPT_CONTEXT_FUNCTION_CONFIG pConfig
);

Parâmetros

[in] dwTable

Identifica a tabela de configuração na qual o contexto existe. Esse pode ser um dos valores a seguir.

Valor Significado
CRYPT_LOCAL
 O contexto existe na tabela de configuração do computador local.
CRYPT_DOMAIN
 Esse valor não está disponível para uso.

[in] pszContext

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o identificador do contexto para o qual definir as informações de configuração da função criptográfica.

[in] dwInterface

Identifica a interface criptográfica para a qual definir as informações de configuração de função. Esse pode ser um dos valores a seguir.

Valor Significado
BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE
 Defina as informações de configuração de função na lista de funções de criptografia assimétricas.
BCRYPT_CIPHER_INTERFACE
 Defina as informações de configuração de função na lista de funções de codificação.
BCRYPT_HASH_INTERFACE
 Defina as informações de configuração de função na lista de funções de hash.
BCRYPT_RNG_INTERFACE
 Defina as informações de configuração de função na lista de funções de gerador de número aleatório.
BCRYPT_SECRET_AGREEMENT_INTERFACE
 Defina as informações de configuração de função na lista de funções de contrato secreto.
BCRYPT_SIGNATURE_INTERFACE
 Defina as informações de configuração de função na lista de funções de assinatura.
NCRYPT_KEY_STORAGE_INTERFACE
 Defina as informações de configuração de função na lista de funções de armazenamento de chaves.
NCRYPT_SCHANNEL_INTERFACE
 Defina as informações de configuração de função na lista de funções Schannel.
NCRYPT_SCHANNEL_SIGNATURE_INTERFACE
 Defina as informações de configuração de função na lista de pacotes de assinaturas que o Schannel aceita para o TLS 1.2.

Windows Vista e Windows Server 2008: Não há suporte para esse valor.

[in] pszFunction

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o identificador da função criptográfica para a qual definir as informações de configuração.

[in] pConfig

O endereço de uma estrutura CRYPT_CONTEXT_FUNCTION_CONFIG que contém as novas informações de configuração de função.

Retornar valor

Retorna um código status que indica o êxito ou a falha da função.

Os códigos de retorno possíveis incluem, mas não se limitam a, o seguinte.

Código de retorno Descrição
STATUS_SUCCESS
 A função foi bem-sucedida.
STATUS_INVALID_PARAMETER
 Um ou mais dos parâmetros não são válidos.
STATUS_NO_MEMORY
 Ocorreu uma falha de alocação de memória.

Comentários

BCryptConfigureContextFunction só pode ser chamado no modo de usuário.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho bcrypt.h
Biblioteca Bcrypt.lib
DLL Bcrypt.dll

Confira também

CRYPT_CONTEXT_FUNCTION_CONFIG