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

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

  • Статья

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

Синтаксис

DWORD ResUtilGetBinaryValue(
  [in]            HKEY    hkeyClusterKey,
  [in]            LPCWSTR pszValueName,
  [out, optional] LPBYTE  *ppbOutValue,
  [out]           LPDWORD pcbOutValueSize
);

Параметры

[in] hkeyClusterKey

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

[in] pszValueName

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

[out, optional] ppbOutValue

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

[out] pcbOutValueSize

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

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

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

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

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

Комментарии

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

Требования

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

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

ClusterRegQueryValue

ResUtilGetDwordValue

ResUtilGetExpandSzValue

ResUtilGetMultiSzValue

ResUtilGetSzValue