ResUtilGetSzValue function (resapi.h)

Article
02/22/2024

Returns a string value from the cluster database.

Syntax

LPWSTR ResUtilGetSzValue(
  [in] HKEY    hkeyClusterKey,
  [in] LPCWSTR pszValueName
);

Parameters

[in] hkeyClusterKey

Key identifying the location of the value in the cluster database.

[in] pszValueName

A null-terminated Unicode string containing the name of the value to retrieve.

Return value

If the operation succeeds, the function returns a pointer to a buffer containing the string value.

If the operation fails, the function returns NULL. For more information, call the function GetLastError.

Remarks

The ResUtilGetSzValue utility function allocates the necessary memory for the string parameter value before calling the Cluster API function ClusterRegQueryValue to access the cluster database. When you are finished with this memory, you must call the function LocalFree to release it.

ResUtilGetSzValue also supports expandable and multiple string formats.

Requirements

Requirement	Value
Minimum supported client	None supported
Minimum supported server	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Target Platform	Windows
Header	resapi.h
Library	ResUtils.lib
DLL	ResUtils.dll