Función BCryptSetProperty (bcrypt.h)

Artículo
07/16/2024

La función BCryptSetProperty establece el valor de una propiedad con nombre para un objeto CNG.

Sintaxis

NTSTATUS BCryptSetProperty(
  [in, out] BCRYPT_HANDLE hObject,
  [in]      LPCWSTR       pszProperty,
  [in]      PUCHAR        pbInput,
  [in]      ULONG         cbInput,
  [in]      ULONG         dwFlags
);

Parámetros

[in, out] hObject

Identificador que representa el objeto CNG para el que se va a establecer el valor de propiedad.

[in] pszProperty

Puntero a una cadena Unicode terminada en null que contiene el nombre de la propiedad que se va a establecer. Puede ser uno de los identificadores de propiedad primitivos de criptografía predefinidos o un identificador de propiedad personalizado.

[in] pbInput

Dirección de un búfer que contiene el nuevo valor de propiedad. El parámetro cbInput contiene el tamaño de este búfer.

[in] cbInput

Tamaño, en bytes, del búfer de pbInput.

[in] dwFlags

Conjunto de marcas que modifican el comportamiento de esta función. No se definen marcas para esta función.

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_HANDLE	El identificador del parámetro hObject no es válido.
STATUS_INVALID_PARAMETER	Uno o varios parámetros no son válidos.
STATUS_NOT_SUPPORTED	No se admite la propiedad con nombre especificada por el parámetro pszProperty o es de solo lectura.

Observaciones

En función de los modos de procesador que admite un proveedor, se puede llamar a BCryptSetProperty desde el modo de usuario o el modo kernel. Los autores de llamadas en modo kernel se pueden ejecutar en PASSIVE_LEVELIRQL o DISPATCH_LEVEL IRQL. Si el nivel IRQL actual es DISPATCH_LEVEL, los punteros pasados a BCryptSetProperty deben hacer referencia a la memoria no paginada (o bloqueada). Si el objeto especificado en el parámetro hObject es un identificador, debe haberse abierto mediante la marca BCRYPT_PROV_DISPATCH.

Para llamar a esta función en modo kernel, use Cng.lib, que forma parte del Kit de desarrollo de controladores (DDK). Windows Server 2008 y Windows Vista: Para llamar a esta función en modo kernel, use Ksecdd.lib.

Al establecer el valor de la propiedad BCRYPT_CHAINING_MODE, el parámetro pbInput no está enlazado por cbInput. El autor de la llamada debe asegurarse de que se proporciona una cadena Unicode terminada en NULL válida.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [aplicaciones de escritorio \| Aplicaciones para UWP]
servidor mínimo admitido	Windows Server 2008 [aplicaciones de escritorio \| Aplicaciones para UWP]
de la plataforma de destino de	Windows
encabezado de	bcrypt.h
biblioteca de	Bcrypt.lib
DLL de	Bcrypt.dll

Compartir a través de