ResUtilGetBinaryValue

The ResUtilGetBinaryValue utility function returns a binary value from the cluster database.

DWORD WINAPI ResUtilGetBinaryValue(
  HKEY ClusterKey,             
  LPCWSTR ValueName,           
  LPBYTE * OutValue,           
  DWORD * OutValueSize  
);
 

Parameters

ClusterKey

[in] Key in the cluster database that identifies the location of the value to retrieve.

ValueName

[in] Pointer to the name of the value to retrieve.

OutValue

[out] Address of the pointer to the retrieved value.

OutValueSize

[out] Pointer to a DWORD in which the size in bytes of the buffer pointed to by OutValue is returned.

Return Values

ERROR_SUCCESS

The value was returned successfully from the cluster database.

ERROR_NOT_ENOUGH_MEMORY

There was an error allocating memory for the value.

ResUtilGetBinaryValue can also return Win32® error codes that are returned by ClusterRegQueryValue.

Notes to Callers

ResUtilGetBinaryValue takes care of allocating the necessary memory for the value and calls the Cluster API function ClusterRegQueryValue. When you are finished with the allocated memory, you must call the Win32 function LocalFree to release it.

QuickInfo

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