Función BCryptSetProperty (bcrypt.h)

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 predefinidos de propiedad primitiva de criptografía 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 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 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_HANDLE	El identificador del parámetro hObject no es válido.
STATUS_INVALID_PARAMETER	Uno o más parámetros no son válidos.
STATUS_NOT_SUPPORTED	La propiedad con nombre especificada por el parámetro pszProperty no se admite o es de solo lectura.

Comentarios

En función de los modos de procesador que admita 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 de 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	Value
Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	bcrypt.h
Library	Bcrypt.lib
Archivo DLL	Bcrypt.dll