ResUtilSetSzValue

The ResUtilSetSzValue utility function sets a string value in the cluster database.

DWORD WINAPI ResUtilSetSzValue(
  HKEY ClusterKey,    
  LPCWSTR ValueName,    
  LPCWSTR NewValue,    
  LPWSTR * OutValue  
);
 

Parameters

ClusterKey

[in] Key identifying the location of the string value in the cluster database.

ValueName

[in] Name of the value to update.

NewValue

[in] Pointer to the new string value.

OutValue

[in, out] Address of a pointer to the new string value.

Return Values

ERROR_SUCCESS

The operation completed successfully.

ERROR_NOT_ENOUGH_MEMORY

An error occurred while attempting to allocate memory.

ResUtilSetSzValue can also return Win32® error codes that are returned by ClusterRegSetValue.

Notes to Callers

ResUtilSetSzValue allocates memory for the new value and calls the Cluster API function ClusterRegSetValue. If necessary, a previous value is deallocated. The new value is copied to the contents of OutValue.

QuickInfo

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