Share via

Función BCryptAddContextFunction (bcrypt.h)

  • Artículo

[BCryptAddContextFunction 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 BCryptAddContextFunction agrega una función criptográfica a la lista de funciones admitidas por un contexto de CNG existente.

Sintaxis

NTSTATUS BCryptAddContextFunction(
  [in] ULONG   dwTable,
  [in] LPCWSTR pszContext,
  [in] ULONG   dwInterface,
  [in] LPCWSTR pszFunction,
  [in] ULONG   dwPosition
);

Parámetros

[in] dwTable

Identifica la tabla de configuración en la que existe el contexto. Puede ser uno de los siguientes valores.

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 al que se va a agregar la función.

[in] dwInterface

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

Valor Significado
BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE
 Agregue la función a la lista de funciones de cifrado asimétricas.
BCRYPT_CIPHER_INTERFACE
 Agregue la función a la lista de funciones de cifrado.
BCRYPT_HASH_INTERFACE
 Agregue la función a la lista de funciones hash.
BCRYPT_RNG_INTERFACE
 Agregue la función a la lista de funciones de generador de números aleatorios.
BCRYPT_SECRET_AGREEMENT_INTERFACE
 Agregue la función a la lista de funciones de acuerdo secreto.
BCRYPT_SIGNATURE_INTERFACE
 Agregue la función a la lista de funciones de firma.
NCRYPT_KEY_STORAGE_INTERFACE
 Agregue la función a la lista de funciones de almacenamiento de claves.
NCRYPT_SCHANNEL_INTERFACE
 Agregue la función a la lista de funciones de Schannel.
NCRYPT_SCHANNEL_SIGNATURE_INTERFACE
 Agregue la función a la lista de conjuntos de firmas que Schannel aceptará 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 que se va a agregar.

[in] dwPosition

Especifica la posición de la lista en la que se va a insertar esta función. La función se inserta en esta posición delante de las funciones existentes. El valor CRYPT_PRIORITY_TOP se usa para insertar la función en la parte superior de la lista. El valor CRYPT_PRIORITY_BOTTOM se usa para insertar la función al final de la lista.

Valor devuelto

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

Entre los códigos de retorno posibles 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.
STATUS_NOT_FOUND
 No se encontró el contexto.

Comentarios

Si la función agregada ya está en la lista, se quitará e insertará en la nueva posición.

Solo se puede llamar a BCryptAddContextFunction 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

BCryptRemoveContextFunction