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


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

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

Синтаксис

DWORD WINAPI_INLINE ResUtilGetMultiSzValue(
  [in]            HKEY    hkeyClusterKey,
  [in]            LPCWSTR pszValueName,
  [out, optional] LPWSTR  *ppszOutValue,
  [out]           LPDWORD pcbOutValueSize
);

Параметры

[in] hkeyClusterKey

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

[in] pszValueName

Указатель на строку Юникода, завершающуюся null, которая содержит имя извлекаемого значения.

[out, optional] ppszOutValue

Адрес указателя на полученное значение.

[out] pcbOutValueSize

Указатель на DWORD , в котором возвращается размер буфера в байтах, на который указывает ppszOutValue .

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

Если операции выполняются успешно, функция возвращает ERROR_SUCCESS.

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

Код возврата Описание
ERROR_NOT_ENOUGH_MEMORY
Ошибка при выделении памяти.

Комментарии

Завершив выделение памяти для значения, возвращаемого служебной функцией ResUtilGetMultiSzValue , необходимо вызвать функцию LocalFree , чтобы освободить ее.

Требования

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

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

ClusterRegQueryValue

ResUtilGetBinaryValue

ResUtilGetDwordValue

ResUtilGetExpandSzValue

ResUtilGetSzValue