Compartir a través de

Función BCryptSetContextFunctionProperty (bcrypt.h)

  • Artículo

La función BCryptSetContextFunctionProperty establece el valor de una propiedad con nombre para una función criptográfica en un contexto CNG existente.

Sintaxis

NTSTATUS BCryptSetContextFunctionProperty(
  [in] ULONG   dwTable,
  [in] LPCWSTR pszContext,
  [in] ULONG   dwInterface,
  [in] LPCWSTR pszFunction,
  [in] LPCWSTR pszProperty,
  [in] ULONG   cbValue,
  [in] PUCHAR  pbValue
);

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 en el que se va a establecer la propiedad de función.

[in] dwInterface

Identifica la interfaz criptográfica en la que existe la función. Puede ser uno de los siguientes valores.

Valor Significado
BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE
 La función existe en la lista de funciones de cifrado asimétricas.
BCRYPT_CIPHER_INTERFACE
 La función existe en la lista de funciones de cifrado.
BCRYPT_HASH_INTERFACE
 La función existe en la lista de funciones hash.
BCRYPT_RNG_INTERFACE
 La función existe en la lista de funciones de generador de números aleatorios.
BCRYPT_SECRET_AGREEMENT_INTERFACE
 La función existe en la lista de funciones de acuerdo secreto.
BCRYPT_SIGNATURE_INTERFACE
 La función existe en la lista de funciones de firma.
NCRYPT_KEY_STORAGE_INTERFACE
 La función existe en la lista de funciones de almacenamiento de claves.
NCRYPT_SCHANNEL_INTERFACE
 La función existe en la lista de funciones de Schannel.

[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 propiedad .

[in] pszProperty

Puntero a una cadena Unicode terminada en null que contiene el identificador de la propiedad que se va a establecer.

[in] cbValue

Contiene el tamaño, en bytes, del búfer pbValue . Este es el número exacto de bytes que se almacenarán. Si el valor de la propiedad es una cadena, debe agregar el tamaño de un carácter para almacenar también el carácter nulo de terminación, si es necesario.

[in] pbValue

Dirección de un búfer que contiene el nuevo valor de propiedad.

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_ACCESS_DENIED
 El autor de la llamada no tiene acceso de escritura a las propiedades de la función.
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 o la función especificados.

Comentarios

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