Здравствуйте, уважаемые подписчики. Перед вами очередной выпуск рассылки "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
Раздел "MSDN по-русски": http://www.bcbdev.ru/msdn/index.php
Обновления на сайте
В раздел Примеры кода добавился пример "Преобразование битового образа в область
(регион)".
Перевод
Сегодня вашему вниманию представлен перевод функции RegCloseKey.
RegCloseKey
Функция RegCloseKey освобождает дескриптор заданного раздела.
LONG RegCloseKey(
HKEY hKey // дескриптор закрываемого раздела
);
Параметры
hKey – идентифицирует закрываемый раздел.
Возвращаемые значения
В случае успеха возвращается ERROR_SUCCESS.
В случае неудачи возвращается ненулевой код ошибки, определенный в WINERROR.H.
Вы можете использовать функцию FormatMessage с флагом
FORMAT_MESSAGE_FROM_SYSTEM для получения общего описания ошибки.
Комментарии
Дескриптор заданного раздела не должен использоваться после того, как раздел
был закрыт. Дескрипторы разделов не должны оставаться
открытыми дольше, чем это необходимо.
Функция RegCloseKey не обязательно записывает информацию в реестр перед возвращением
управления; сброс кэша на жесткий диск может занять
порядка нескольких секунд. Если приложение должно явно записывать информацию
реестра на жесткий диск, оно может использовать функцию
RegFlushKey. Тем не менее, RegFlushKey использует много системных ресурсов, и
должна вызываться только в случае необходимости.
См. также
RegCreateKey, RegCreateKeyEx, RegDeleteKey, RegFlushKey, RegOpenKey, RegOpenKeyEx,
RegSetValue, RegSetValueEx
Справочник по WinAPI: http://www.bcbdev.ru/winapi/win32api.exe
Справочник по WinAPI (zip-версия): http://www.bcbdev.ru/winapi/win32api.zip
Дружественная рассылка "Программирование на WinAPI": http://subscribe.ru/catalog/comp.soft.prog.russianmsdn
С уважением,
ведущий рассылки
Тарас Сорока.
mailto:stathome@rol.ru