RegUnLoadKey

Функция RegUnLoadKey выгружает указанный ключ и его подключи из реестра.

LONG RegUnLoadKey(
    HKEY hKey,  // дескриптор открытого ключа
    LPCTSTR lpSubKey  // адрес имени подключа
   );

Параметры:

hKey	Определяет выгружаемый ключ. Это может быть предопределенный зарезервированный дескриптор, или дескриптор возвращенный при вызове RegConnectRegistry. Зарезервированные предопределенные дескрипторы, это: HKEY_LOCAL_MACHINE HKEY_USERS
lpSubKey	Адрес нульзаканчивающейся строки, содержащей имя выгружаемого подключа. Ключ, указанный в параметре lpSubKey, должен быть ключом, созданным при использовании функции RegLoadKey.

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

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

При ошибке, возвращаемое значение – это код ошибки, объявленный в WINERROR.H. Вы можете использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM для получения общего описания ошибки.

Замечания:

Эта функция удаляет из реестра улей, но не изменяет файл, который содержит информацию реестра. Улей – это отдельное тело ключей, подключей, и значений, которые размещаются на вершине дерева иерархии реестра.

Windows NT/2000/XP: вызывающий процесс должен иметь привилегию SE_RESTORE_NAME.