Función ResUtilFindBinaryProperty (resapi.h)

Artículo
08/25/2023

Busca una propiedad binaria especificada en una lista de propiedades y también puede devolver el valor de la propiedad . El tipo PRESUTIL_FIND_BINARY_PROPERTY define un puntero a esta función.

Sintaxis

DWORD ResUtilFindBinaryProperty(
  [in]            const PVOID pPropertyList,
  [in]            DWORD       cbPropertyListSize,
  [in]            LPCWSTR     pszPropertyName,
  [out, optional] LPBYTE      *pbPropertyValue,
  [out, optional] LPDWORD     pcbPropertyValueSize
);

Parámetros

[in] pPropertyList

Puntero a la lista de propiedades en la que se va a buscar el valor.

[in] cbPropertyListSize

Tamaño, en bytes, de la lista de propiedades especificada por pPropertyList.

[in] pszPropertyName

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

[out, optional] pbPropertyValue

Puntero a un puntero BYTE a un búfer (asignado por la función) que contiene una copia del valor de propiedad. Debe llamar a LocalFree (en *pbPropertyValue) para liberar la memoria asignada. Si no se requiere ningún valor, pase NULL para este parámetro.

[out, optional] pcbPropertyValueSize

Puntero al tamaño, en bytes, del valor devuelto. Si no se requiere ningún tamaño, pase NULL para este parámetro.

Valor devuelto

Si las operaciones se realizan correctamente, la función devuelve ERROR_SUCCESS.

Si se produce un error en la operación, la función devuelve un código de error del sistema. A continuación se muestran códigos de error posibles.

Código devuelto	Descripción
ERROR_INVALID_DATA	La lista de propiedades tiene un formato incorrecto.
ERROR_NOT_ENOUGH_MEMORY	La función no pudo asignar un búfer en el que devolver el valor de la propiedad.
ERROR_FILE_NOT_FOUND	No se pudo encontrar la propiedad especificada en la lista de propiedades.

Comentarios

Si ResUtilFindBinaryProperty se realiza correctamente, *pbPropertyValue apunta a una copia de los datos almacenados en pPropertyList. Asegúrese de llamar a LocalFree en *pbPropertyValue para evitar pérdidas de memoria.

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Plataforma de destino	Windows
Encabezado	resapi.h
Library	ResUtils.lib
Archivo DLL	ResUtils.dll