ResUtilFindDwordProperty function (resapi.h)

Article
02/22/2024

Locates an unsigned long property value in a property list. The PRESUTIL_FIND_DWORD_PROPERTY type defines a pointer to this function.

Syntax

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

Parameters

[in] pPropertyList

Pointer to the property list in which to locate the value.

[in] cbPropertyListSize

Size in bytes of the data included in pPropertyList.

[in] pszPropertyName

Pointer to a null-terminated Unicode string containing the name of the value to locate.

[out] pdwPropertyValue

Pointer to the actual value of the data stored in the property list buffer.

Return value

If the operations succeeds, the function returns ERROR_SUCCESS.

If the operation fails, the function returns a system error code. The following are possible error codes.

Return code	Description
ERROR_INVALID_DATA	The data is in an incorrect format.
ERROR_FILE_NOT_FOUND	The property could not be located in the property list.

Remarks

If the operation is successful, pdwPropertyValue points directly into the property list buffer. Be careful not to disturb the formatting of the property list when using pdwPropertyValue.

Requirements

Requirement	Value
Minimum supported client	None supported
Minimum supported server	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Target Platform	Windows
Header	resapi.h
Library	ResUtils.lib
DLL	ResUtils.dll