ClusterRegSetValue

The ClusterRegSetValue function sets a value for a cluster database key.

DWORD WINAPI ClusterRegSetValue(
  HKEY hKey,             
  LPCWSTR lpszValueName, 
  DWORD dwType,          
  CONST BYTE * lpbData,  
  DWORD cbData           
);
 

Parameters

hKey

[in] Handle to a cluster database key.

lpszValueName

[in] Pointer to the name of the value to set. If a value with this name is not already present in the resource, ClusterRegSetValue adds it to the resource.

dwType

[in] Type of information to be stored as the value's data. This parameter can be one of the following values:

REG_BINARY

Binary data in any form.

REG_DWORD

A 32-bit number.

REG_EXPAND_SZ

A NULL-terminated Unicode string that contains unexpanded references to environment variables (for example, "%PATH%").

REG_MULTI_SZ

An array of NULL-terminated Unicode strings, terminated by two NULL characters.

REG_NONE

No defined value type.

REG_SZ

A NULL-terminated Unicode string.

lpbData

[in] Pointer to the data to be stored with the name pointed to by lpszValueName.

cbData

[in] Count of bytes in the data pointed to by the lpData parameter. If the data is of type REG_SZ, REG_EXPAND_SZ, or REG_MULTI_SZ, cbData must include the size of the terminating NULL character.

Return Values

ERROR_SUCCESS

The operation was successful.

If the operation was unsuccessful, ClusterRegSetValue returns a Win32 error value. For detailed information about the error, call the Win32 function GetLastError.

Remarks

For more information, see the related Win32 function RegSetValue.

QuickInfo

  Version: Use Windows NT Server Enterprise Edition 4.0.
  Windows CE: Unsupported.
  Header: Declared in clusapi.h.