ResUtilSetDwordValue function (resapi.h)

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

See also

ClusterRegSetValue

ResUtilSetBinaryValue

ResUtilSetExpandSzValue

ResUtilSetMultiSzValue

ResUtilSetSzValue