Função BCryptAddContextFunction (bcrypt.h)
[BCryptAddContextFunction 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 BCryptAddContextFunction adiciona uma função criptográfica à lista de funções compatíveis com um contexto CNG existente.
Sintaxe
NTSTATUS BCryptAddContextFunction(
[in] ULONG dwTable,
[in] LPCWSTR pszContext,
[in] ULONG dwInterface,
[in] LPCWSTR pszFunction,
[in] ULONG dwPosition
);
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 |
---|---|
|
O contexto existe na tabela de configuração do computador local. |
|
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 ao qual adicionar a função.
[in] dwInterface
Identifica a interface criptográfica à qual adicionar a função. Esse pode ser um dos valores a seguir.
[in] pszFunction
Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o identificador da função criptográfica a ser adicionada.
[in] dwPosition
Especifica a posição na lista na qual inserir essa função. A função é inserida nessa posição à frente de qualquer função existente. O valor CRYPT_PRIORITY_TOP é usado para inserir a função na parte superior da lista. O valor CRYPT_PRIORITY_BOTTOM é usado para inserir a função no final da lista.
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 |
---|---|
|
A função foi bem-sucedida. |
|
Um ou mais dos parâmetros não são válidos. |
|
Ocorreu uma falha de alocação de memória. |
|
Não foi possível encontrar o contexto. |
Comentários
Se a função adicionada já estiver na lista, ela será removida e inserida na nova posição.
BCryptAddContextFunction 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 |