Windows - статьи




Программирование для системного реестра на С++ - часть 9


Функция перечисляет параметры раздела, определяемого описателем.

  • hKey Описатель открытого раздела. Раздел должен быть открыт с правами KEY_QUERY_VALUE.
  • dwIndex Индекс параметра. При первом вызове этот параметр должен быть равен нулю, а затем увеличиваться, для получения всех параметров раздела. Поскольку значения не упорядочены, то функция может возвращать их в любом порядке.
  • lpValueName Указатель на буфер, который получает название параметра, должен оканчиваться нулевым символом.
  • lpcValueName Указатель на переменную, которая определяет размер буфера, на который указывает lpValueName, в TCHAR. Параметр должен включать завершающий нуль-символ. После возврата значения функцией, этот параметр будет содержать кол-во символов, записанных в буфер. Возвращаемое кол-во не включает нуль-символ.
  • lpReserved Зарезервировано - NULL.
  • lpType Указатель на переменную, которая содержит тип данных, сохраненных в параметре. Может быть - NULL.
  • lpData Указатель на буфер, который получает данные параметра. Может быть - NULL. Если этот параметр - NULL, а lpcbData не NULL, функция сохраняет размер данных, в байтах, в переменной, на которую указывает lpcbData.
  • lpcbData Указатель на переменную, определяющую размер буфера, на который указывает lpData, в байтах. Когда функция возвратит значение, переменная будет содержать кол-во байт, сохраненных в буфере. Может быть NULL, только если lpData - NULL. Если данные имеют тип REG_XXX_SZ, этот размер включает все завершающие нули.

Если буфер, указанный в lpData недостаточен для сохранения в нем данных, то функция возвращает ERROR_MORE_DATA и сохраняет требуемый размер буфера в переменной, на которую указывает lpcbData. Если функция выполнена успешно, то возвращается - ERROR_SUCCESS. В противном случае возвращает системный код ошибки, определенный в WinError.h.

LONG RegSetValueEx(HKEY hKey, LPCTSTR lpValueName, DWORD Reserved, DWORD dwType, const BYTE* lpData, DWORD cbData)

Функция устанавливает значение параметра.

  • hKey Описатель открытого раздела.


    Содержание  Назад  Вперед