Función BCryptQueryContextFunctionProperty (bcrypt.h)

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

Sintaxis

NTSTATUS BCryptQueryContextFunctionProperty(
  [in]      ULONG   dwTable,
  [in]      LPCWSTR pszContext,
  [in]      ULONG   dwInterface,
  [in]      LPCWSTR pszFunction,
  [in]      LPCWSTR pszProperty,
  [in, out] ULONG   *pcbValue,
  [in, out] PUCHAR  *ppbValue
);

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 obtener la propiedad de función.

[in] dwInterface

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

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 obtener la propiedad .

[in] pszProperty

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

[in, out] pcbValue

La dirección de una variable ULONG que, en la entrada, contiene el tamaño, en bytes, del búfer al que apunta ppbValue. Si este tamaño no es lo suficientemente grande como para contener el valor de la propiedad, se producirá un error en esta función con STATUS_BUFFER_TOO_SMALL.

Una vez que se devuelve esta función, esta variable contiene el número de bytes que se copiaron en el búfer ppbValue .

[in, out] ppbValue

Dirección de un puntero a un búfer que recibe los datos de propiedad. El tamaño y el formato de este búfer dependen del formato de la propiedad que se va a recuperar. El valor al que apunta el parámetro pcbValue contiene el tamaño de este búfer.

Si el valor al que apunta este parámetro es NULL, esta función asignará la memoria necesaria. Esta memoria debe liberarse cuando ya no sea necesaria pasando este puntero a la función BCryptFreeBuffer .

Si este parámetro es NULL, esta función colocará el tamaño necesario, en bytes, en la variable a la que apunta el parámetro pcbValue y devolverá STATUS_BUFFER_TOO_SMALL.

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_BUFFER_TOO_SMALL	El parámetro ppbValue no es NULL y el valor al que apunta el parámetro pcbValue no es lo suficientemente grande como para contener el conjunto de contextos.
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, la función o la propiedad especificados.

Comentarios

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