Поделиться через


Функция ResUtilGetSzValue (resapi.h)

Возвращает строковое значение из базы данных кластера.

Синтаксис

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

Параметры

[in] hkeyClusterKey

Ключ, определяющий расположение значения в базе данных кластера.

[in] pszValueName

Строка Юникода с символом NULL, содержащая имя извлекаемого значения.

Возвращаемое значение

Если операция выполнена успешно, функция возвращает указатель на буфер, содержащий строковое значение.

Если операция завершается сбоем, функция возвращает значение NULL. Для получения дополнительных сведений вызовите функцию GetLastError.

Комментарии

Служебная функция ResUtilGetSzValue выделяет необходимую память для значения строкового параметра перед вызовом функции API кластераClusterRegQueryValue для доступа к базе данных кластера. После завершения работы с этой памятью необходимо вызвать функцию LocalFree, чтобы освободить ее.

ResUtilGetSzValue также поддерживает расширяемые и несколько строковых форматов.

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows Server 2008 Корпоративная, Windows Server 2008 Datacenter
Целевая платформа Windows
Header resapi.h
Библиотека ResUtils.lib
DLL ResUtils.dll

См. также раздел

ClusterRegQueryValue

ResUtilGetBinaryValue

ResUtilGetDwordValue

ResUtilGetExpandSzValue

ResUtilGetMultiSzValue