Функция 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.
Если операция завершается сбоем, функция возвращает код системной ошибки. Ниже приведен возможный код ошибки.
Код возврата | Описание |
---|---|
|
Ошибка при выделении памяти. |
Комментарии
Завершив выделение памяти для значения, возвращаемого служебной функцией ResUtilGetMultiSzValue , необходимо вызвать функцию LocalFree , чтобы освободить ее.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Ни одна версия не поддерживается |
Минимальная версия сервера | Windows Server 2008 Корпоративная, Windows Server 2008 Datacenter |
Целевая платформа | Windows |
Header | resapi.h |