Здравствуйте, уважаемые подписчики. Перед вами очередной выпуск рассылки "WinAPI
на русском".
Сайт рассылки: http://www.bcbdev.ru. Материалы по Win32 API, C++Builder.
Раздел "WinAPI": http://www.bcbdev.ru/winapi.htm
Раздел "C++Builder": http://www.bcbdev.ru/cbuilder.htm
Раздел "Примеры кода": http://www.bcbdev.ru/codesamples.htm
Обновления на сайте
Нет.
Перевод
Сегодня вашему вниманию представлен перевод функции SHGetValue.
SHGetValue
Функция SHGetValue извлекает значение параметра из реестра.
DWORD SHGetValue(
HKEY hkey,
LPCTSTR pszSubKey,
LPCTSTR pszValue,
LPDWORD pdwType,
LPVOID pvData,
LPDWORD pcbData
);
Параметры
hkey – дескриптор текущего открытого раздела, или любое из следующих значений:
HKEY_CLASSES_ROOT
HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER
HKEY_DYN_DATA (только Microsoft® Windows® 95)
HKEY_LOCAL_MACHINE
HKEY_PERFORMANCE_DATA (только Microsoft Windows NT®)
HKEY_USERS
pszSubKey – адрес завершающейся нулем строки, которая определяет имя подраздела,
из которого будет извлекаться значение.
pszValue –название параметра, чье значение извлекается.
pdwType – тип значения. Для дополнительной информации смотрите раздел "Типы данных
реестра".
pvData – адрес буфера назначения.
pcbData – размер буфера назначения.
Возвращаемые значения
В случае успеха возвращается ERROR_SUCCESS.
В случае неудачи возвращается ненулевой код ошибки, определенный в Winerror.h.
Вы можете использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM
для извлечения общего описания ошибки.
Комментарии
Если ваше приложение должно извлекать/устанавливать серию значений параметров
в одном разделе, лучше будет один раз открыть раздел и установить/извлечь значения
параметров обычными функциями Windows API для работы с реестром, чем неоднократно
использовать эту функцию.
Требования
Минимальная версия DLL: shlwapi.dll версии 4.71 и выше.
Заголовок: shlwapi.h.
Библиотека импорта: shlwapi.lib.
Минимальные ОС: Windows 2000, Windows NT 4.0 с Internet Explorer 4.0, Windows
98, Windows 95 с Internet Explorer 4.0.
хелп по WinAPI: http://www.bcbdev.ru/winapi/win32api.exe
С уважением,
ведущий рассылки
Тарас Сорока.
mailto:tnsoroka@online.ru