ResUtilFindSzProperty function (resapi.h)
Locates a string property in a property list. The PRESUTIL_FIND_SZ_PROPERTY type defines a pointer to this function.
Syntax
DWORD ResUtilFindSzProperty(
[in] const PVOID pPropertyList,
[in] DWORD cbPropertyListSize,
[in] LPCWSTR pszPropertyName,
[out, optional] LPWSTR *pszPropertyValue
);
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, optional] pszPropertyValue
Pointer to a WCHAR pointer to a buffer (allocated by the function) containing a copy of the property value. You must call LocalFree (on *pszPropertyValue) to free the allocated memory. If no value 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 ResUtilFindSzProperty is successful, *pszPropertyValue points to a copy of the data stored in pPropertyList. Be sure to call LocalFree on *pszPropertyValue 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 |