Función ResUtilFindLongProperty (resapi.h)

Artículo
03/01/2024

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

Sintaxis

DWORD ResUtilFindLongProperty(
  [in]  const PVOID pPropertyList,
  [in]  DWORD       cbPropertyListSize,
  [in]  LPCWSTR     pszPropertyName,
  [out] LPLONG      plPropertyValue
);

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] plPropertyValue

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 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, plPropertyValue apunta directamente al búfer de lista de propiedades. Tenga cuidado de no molestar el formato de la lista de propiedades al usar plPropertyValue.

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