ResUtilGetPropertySize function (resapi.h)

Returns the total number of bytes required for a specified property.


DWORD ResUtilGetPropertySize(
  [in]      HKEY                         hkeyClusterKey,
  [in]      const PRESUTIL_PROPERTY_ITEM pPropertyTableItem,
  [in, out] LPDWORD                      pcbOutPropertyListSize,
  [in, out] LPDWORD                      pnPropertyCount


[in] hkeyClusterKey

Cluster database key identifying the location of the property to size.

[in] pPropertyTableItem

Pointer to a RESUTIL_PROPERTY_ITEM structure describing the property to size.

[in, out] pcbOutPropertyListSize

Pointer to the total number of bytes required for the property value, which includes the CLUSPROP_VALUE structure and the data.

[in, out] pnPropertyCount

Pointer to the total number of properties. This value is incremented to include this property if ResUtilGetPropertySize is successful.

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
One or more of the input parameters were invalid.
The data type of a property specified in the property table does not match the data type of the same-named property stored in the cluster database.


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

See also