ResUtilSetUnknownProperties function (resapi.h)

Stores a cluster object's unknown properties in the cluster database.

Syntax

DWORD ResUtilSetUnknownProperties(
  [in] HKEY                         hkeyClusterKey,
  [in] const PRESUTIL_PROPERTY_ITEM pPropertyTable,
  [in] const PVOID                  pInPropertyList,
  [in] DWORD                        cbInPropertyListSize
);

Parameters

[in] hkeyClusterKey

Cluster database key identifying the location of the properties to set.

[in] pPropertyTable

Pointer to a property table specifying properties that should NOT be set by this function.

[in] pInPropertyList

Pointer to a property list. Any properties that appear in this list and that do NOT appear in pInPropertyList are set.

[in] cbInPropertyListSize

Pointer to the size in bytes of the input buffer pointed to by pInPropertyList.

Return value

If the operation succeeds, the function returns ERROR_SUCCESS.

If the operation fails, the function returns a system error code.

Remarks

ResUtilSetUnknownProperties only sets the properties listed in pInPropertyList that are NOT listed in pPropertyTable.

Use the ResUtilAddUnknownProperties to create the property list and ResUtilGetAllProperties to retrieve unknown properties.

Do not call ResUtilSetUnknownProperties from the following resource DLL entry point functions:

ResUtilSetUnknownProperties 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

See also

ResUtilAddUnknownProperties

ResUtilGetAllProperties