ResUtilSetPropertyParameterBlockEx function (resapi.h)
Sets properties in the cluster database from a parameter block.
Syntax
DWORD ResUtilSetPropertyParameterBlockEx(
[in] HKEY hkeyClusterKey,
[in] const PRESUTIL_PROPERTY_ITEM pPropertyTable,
[in] PVOID Reserved,
[in] const LPBYTE pInParams,
[in] const PVOID pInPropertyList,
[in] DWORD cbInPropertyListSize,
[in] BOOL bForceWrite,
[out, optional] LPBYTE pOutParams
);
Parameters
[in] hkeyClusterKey
Cluster database key identifying the location for the properties to set.
[in] pPropertyTable
Pointer to an array of RESUTIL_PROPERTY_ITEM structures describing the properties to set.
[in] Reserved
Reserved.
[in] pInParams
Pointer to an input parameter block containing the data for the properties described in the property table pointed to by pPropertyTable.
[in] pInPropertyList
Pointer to the input buffer containing a property list or NULL. If pInPropertyList is not NULL, any properties listed in the property list that are not listed in the property table are also set in the cluster database.
[in] cbInPropertyListSize
Size in bytes of the input buffer pointed to by pInPropertyList.
[in] bForceWrite
Forces the property values to be written to the cluster database even if the new values are identical to the existing values
[out, optional] pOutParams
Pointer to a parameter block to receive data copied from the pInParams parameter.
Return value
If the operation 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 syntax, format, or type of a property in the property table pointed to by pPropertyTable is incorrect, or a property is read-only and cannot be updated. |
|
One or more of the input parameters were invalid. |
Remarks
Do not call ResUtilSetPropertyParameterBlockEx from the following resource DLL entry point functions:
ResUtilSetPropertyParameterBlockEx can be safely called from any other resource DLL entry point function or from a worker thread. For more information, see Function Calls to Avoid in Resource DLLs.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 |