Función BCryptCreateContext (bcrypt.h)

  • Artículo

[BCryptCreateContext está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

La función BCryptCreateContext crea un nuevo contexto de configuración de CNG.

Sintaxis

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

Parámetros

[in] dwTable

Identifica la tabla de configuración en la que se va a crear el contexto. Puede ser uno de los valores siguientes.

Valor Significado
CRYPT_LOCAL
 Cree el contexto en la tabla de configuración del equipo local.
CRYPT_DOMAIN
 Este valor no está disponible para su uso.

[in] pszContext

Puntero a una cadena Unicode terminada en null que contiene el identificador del contexto que se va a crear.

[in, optional] pConfig

Puntero a una estructura de CRYPT_CONTEXT_CONFIG que contiene datos de configuración adicionales para el nuevo contexto. Este parámetro puede ser NULL si no es necesario.

Valor devuelto

Devuelve un código de estado que indica el éxito o error de la función.

Entre los posibles códigos de retorno se incluyen, entre otros, los siguientes.

Código devuelto Descripción
STATUS_SUCCESS
 La función se realizó correctamente.
STATUS_INVALID_PARAMETER
 Uno o más parámetros no son válidos.
STATUS_NO_MEMORY
 Error de asignación de memoria.

Comentarios

Solo se puede llamar a BCryptCreateContext en modo de usuario.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado bcrypt.h
Library Bcrypt.lib
Archivo DLL Bcrypt.dll