ResUtilSetMultiSzValue

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

DWORD WINAPI ResUtilSetMultiSzValue(
  HKEY ClusterKey,    
  LPCWSTR ValueName,    
  LPCWSTR NewValue,    
  DWORD NewValueSize,  
  LPWSTR * OutValue,   
  LPDWORD OutValueSize 
);
 

Parameters

ClusterKey

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

ValueName

[in] Name of the value to update.

NewValue

[in] Pointer to the new multiple string value.

NewValueSize

[in] Size of the new value.

OutValue

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

OutValueSize

[in, out] Pointer to the size of the new value.

Return Values

ERROR_SUCCESS

The operation completed successfully.

ERROR_NOT_ENOUGH_MEMORY

An error occurred while attempting to allocate memory.

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

Notes to Callers

ResUtilSetMultiSzValue allocates memory for the new value and calls the Cluster API function ClusterRegSetValue.

A multiple string value contains data that represents an array of null-terminated strings, terminated by two null characters.

QuickInfo

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