ResUtilFindBinaryProperty function (resapi.h)
Locates a specified binary property in a property list and can also return the value of the property. The PRESUTIL_FIND_BINARY_PROPERTY type defines a pointer to this function.
Syntax
DWORD ResUtilFindBinaryProperty(
[in] const PVOID pPropertyList,
[in] DWORD cbPropertyListSize,
[in] LPCWSTR pszPropertyName,
[out, optional] LPBYTE *pbPropertyValue,
[out, optional] LPDWORD pcbPropertyValueSize
);
Parameters
[in] pPropertyList
Pointer to the property list in which to locate the value.
[in] cbPropertyListSize
Size, in bytes, of the property list specified by pPropertyList.
[in] pszPropertyName
Pointer to a null-terminated Unicode string containing the name of the property to locate.
[out, optional] pbPropertyValue
Pointer to a BYTE pointer to a buffer (allocated by the function) containing a copy of the property value. You must call LocalFree (on *pbPropertyValue) to free the allocated memory. If no value is required, pass NULL for this parameter.
[out, optional] pcbPropertyValueSize
Pointer to the size, in bytes, of the value returned. If no size is required, pass NULL for this parameter.
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 |
|---|---|
|
The property list is incorrectly formatted. |
|
The function could not allocate a buffer in which to return the property value. |
|
The specified property could not be located in the property list. |
Remarks
If ResUtilFindBinaryProperty is successful, *pbPropertyValue points to a copy of the data stored in pPropertyList. Be sure to call LocalFree on *pbPropertyValue to prevent memory leaks.
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 |