ResUtilSetDwordValue function (resapi.h)

Article
02/22/2024

Sets a numeric value in the cluster database. The PRESUTIL_SET_DWORD_VALUE type defines a pointer to this function.

Syntax

DWORD ResUtilSetDwordValue(
  [in]      HKEY    hkeyClusterKey,
  [in]      LPCWSTR pszValueName,
  [in]      DWORD   dwNewValue,
  [in, out] LPDWORD pdwOutValue
);

Parameters

[in] hkeyClusterKey

Key identifying the location of the numeric value in the cluster database.

[in] pszValueName

A null-terminated Unicode string containing the name of the value to update.

[in] dwNewValue

New DWORD value.

[in, out] pdwOutValue

Optional. Pointer to where the updated value should be copied.

Return value

If the operation succeeds, the function returns ERROR_SUCCESS.

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

Remarks

The ResUtilSetDwordValue utility function updates the cluster database by calling the Cluster API function ClusterRegSetValue.

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

ResUtilSetDwordValue 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