Compartir a través de

Función BCryptConfigureContextFunction (bcrypt.h)

  • Artículo

[BCryptConfigureContextFunction 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 BCryptConfigureContextFunction establece la información de configuración de la función criptográfica de un contexto CNG existente.

Sintaxis

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 la tabla de configuración en la que existe el contexto. Puede ser uno de los valores siguientes.

Valor Significado
CRYPT_LOCAL
 El contexto existe 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 para el que se establece la información de configuración de la función criptográfica.

[in] dwInterface

Identifica la interfaz criptográfica para la que se va a establecer la información de configuración de la función. Puede ser uno de los valores siguientes.

Valor Significado
BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE
 Establezca la información de configuración de la función en la lista de funciones de cifrado asimétrico.
BCRYPT_CIPHER_INTERFACE
 Establezca la información de configuración de la función en la lista de funciones de cifrado.
BCRYPT_HASH_INTERFACE
 Establezca la información de configuración de la función en la lista de funciones hash.
BCRYPT_RNG_INTERFACE
 Establezca la información de configuración de la función en la lista de funciones de generador de números aleatorios.
BCRYPT_SECRET_AGREEMENT_INTERFACE
 Establezca la información de configuración de la función en la lista de funciones de acuerdo secreto.
BCRYPT_SIGNATURE_INTERFACE
 Establezca la información de configuración de la función en la lista de funciones de firma.
NCRYPT_KEY_STORAGE_INTERFACE
 Establezca la información de configuración de la función en la lista de funciones de almacenamiento de claves.
NCRYPT_SCHANNEL_INTERFACE
 Establezca la información de configuración de la función en la lista de funciones de Schannel.
NCRYPT_SCHANNEL_SIGNATURE_INTERFACE
 Establezca la información de configuración de la función en la lista de conjuntos de firmas que Schannel acepta para TLS 1.2.

Windows Vista y Windows Server 2008: Este valor no se admite.

[in] pszFunction

Puntero a una cadena Unicode terminada en null que contiene el identificador de la función criptográfica para la que se va a establecer la información de configuración.

[in] pConfig

Dirección de una estructura de CRYPT_CONTEXT_FUNCTION_CONFIG que contiene la nueva información de configuración de función.

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

BCryptConfigureContextFunction solo se puede llamar 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

Consulte también

CRYPT_CONTEXT_FUNCTION_CONFIG