Función ResUtilFindDwordProperty (resapi.h)

Artículo
03/08/2023

Busca un valor de propiedad long sin signo en una lista de propiedades. El tipo PRESUTIL_FIND_DWORD_PROPERTY define un puntero a esta función.

Sintaxis

DWORD ResUtilFindDwordProperty(
  [in]  const PVOID pPropertyList,
  [in]  DWORD       cbPropertyListSize,
  [in]  LPCWSTR     pszPropertyName,
  [out] LPDWORD     pdwPropertyValue
);

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 los datos incluidos en pPropertyList.

[in] pszPropertyName

Puntero a una cadena Unicode terminada en null que contiene el nombre del valor que se va a buscar.

[out] pdwPropertyValue

Puntero al valor real de los datos almacenados en el búfer de lista de propiedades.

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 los códigos de error posibles.

Código devuelto	Descripción
ERROR_INVALID_DATA	Los datos tienen un formato incorrecto.
ERROR_FILE_NOT_FOUND	No se pudo encontrar la propiedad en la lista de propiedades.

Comentarios

Si la operación se realiza correctamente, pdwPropertyValue apunta directamente al búfer de lista de propiedades. Tenga cuidado de no molestar el formato de la lista de propiedades al usar pdwPropertyValue.

Requisitos


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