Função BCryptCreateContext (bcrypt.h)

  • Artigo

[BCryptCreateContext 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 BCryptCreateContext cria um novo contexto de configuração CNG.

Sintaxe

NTSTATUS BCryptCreateContext(
  [in]           ULONG                 dwTable,
  [in]           LPCWSTR               pszContext,
  [in, optional] PCRYPT_CONTEXT_CONFIG pConfig
);

Parâmetros

[in] dwTable

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

Valor Significado
CRYPT_LOCAL
 Crie o contexto 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 a ser criado.

[in, optional] pConfig

Um ponteiro para uma estrutura CRYPT_CONTEXT_CONFIG que contém dados de configuração adicionais para o novo contexto. Esse parâmetro poderá ser NULL se não for necessário.

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

BCryptCreateContext 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