ResUtilGetSzValue function (resapi.h)

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

See also

ClusterRegQueryValue

ResUtilGetBinaryValue

ResUtilGetDwordValue

ResUtilGetExpandSzValue

ResUtilGetMultiSzValue