Функция SHRegDeleteEmptyUSKeyA (shlwapi.h)
Удаляет пустой подраздел реестра в поддереве конкретного пользователя (HKEY_CURRENT_USER или HKEY_LOCAL_MACHINE).
Синтаксис
LSTATUS SHRegDeleteEmptyUSKeyA(
[in] HUSKEY hUSKey,
[in] LPCSTR pszSubKey,
[in] SHREGDEL_FLAGS delRegFlags
);
Параметры
[in] hUSKey
Тип: HUSKEY
Дескриптор открытого подраздела реестра. Вложенный ключ должен быть открыт с помощью права доступа KEY_SET_VALUE. Дополнительные сведения см. в разделе "Безопасность и права доступа реестра".
Этот дескриптор можно получить с помощью функции SHRegOpenUSKey.
[in] pszSubKey
Тип: LPCSTR
Указатель на строку, завершающуюся значением NULL, которая указывает пустой определяемый пользователем подраздел реестра, который необходимо удалить.
[in] delRegFlags
Тип: SHREGDEL_FLAGS
Один из SHREGDEL_FLAGS, указывающий, из какого базового ключа будет удален вложенный ключ.
Возвращаемое значение
Тип: LSTATUS
Возвращает ERROR_SUCCESS в случае успешного выполнения или ненулевого кода ошибки, определенного в Winerror.h в противном случае. Для получения универсального описания ошибки можно использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM.
Замечания
Заметка
Заголовок shlwapi.h определяет SHRegDeleteEmptyUSKey как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 2000 Профессиональный, Windows XP [только классические приложения] |
| минимальный поддерживаемый сервер | Windows 2000 Server [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | shlwapi.h |
| библиотеки |
Shlwapi.lib |
| DLL | Shlwapi.dll (версия 4.71 или более поздняя) |