Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ResUtilFindBinaryProperty function

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 WINAPI ResUtilFindBinaryProperty(
  _In_      const PVOID   pPropertyList,
  _In_            DWORD   cbPropertyListSize,
  _In_            LPCWSTR pszPropertyName,
  _Out_opt_       LPBYTE  *pbPropertyValue,
  _Out_opt_       LPDWORD pcbPropertyValueSize
);

typedef DWORD (WINAPI *PRESUTIL_FIND_BINARY_PROPERTY)(
    _In_      const PVOID   pPropertyList,
    _In_            DWORD   cbPropertyListSize,
    _In_            LPCWSTR pszPropertyName,
    _Out_opt_       LPBYTE  *pbPropertyValue,
    _Out_opt_       LPDWORD pcbPropertyValueSize
);

Parameters

pPropertyList [in]

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

cbPropertyListSize [in]

Size, in bytes, of the property list specified by pPropertyList.

pszPropertyName [in]

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

pbPropertyValue [out, optional]

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.

pcbPropertyValueSize [out, optional]

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.

ERROR_INVALID_DATA

The property list is incorrectly formatted.

ERROR_NOT_ENOUGH_MEMORY

The function could not allocate a buffer in which to return the property value.

ERROR_FILE_NOT_FOUND

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

Minimum supported client

None supported

Minimum supported server

Windows Server 2008 Enterprise, Windows Server 2008 Datacenter

Header

ResApi.h

Library

ResUtils.lib

DLL

ResUtils.dll

See also

ResUtilFindDwordProperty
ResUtilFindExpandSzProperty
ResUtilFindExpandedSzProperty
ResUtilFindLongProperty
ResUtilFindMultiSzProperty
ResUtilFindSzProperty

 

 

Show: