ResUtilSetExpandSzValue

The ResUtilSetExpandSzValue utility function sets an expandable string value in the cluster database.

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

Parameters

ClusterKey

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

ValueName

[in] Name of the value to update.

NewValue

[in] Pointer to the new expandable string value.

OutValue

[in, out] Pointer to a string containing the updated value.

Return Values

ERROR_SUCCESS

The operation completed successfully.

ERROR_NOT_ENOUGH_MEMORY

An error occurred while attempting to allocate memory.

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

Notes to Callers

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

An expandable string value contains data that represents a null-terminated Unicode string that contains unexpanded references to environment variables such as "%PATH%".

QuickInfo

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