Функция SHRegDeleteEmptyUSKeyW (shlwapi.h)
Удаляет пустой подраздел реестра в поддереве конкретного пользователя (HKEY_CURRENT_USER или HKEY_LOCAL_MACHINE).
Синтаксис
LSTATUS SHRegDeleteEmptyUSKeyW(
[in] HUSKEY hUSKey,
LPCWSTR pwzSubKey,
[in] SHREGDEL_FLAGS delRegFlags
);
Параметры
[in] hUSKey
Тип: HUSKEY
Дескриптор открытого подраздела реестра. Вложенный ключ должен быть открыт с помощью права доступа KEY_SET_VALUE. Дополнительные сведения см. в разделе "Безопасность и права доступа реестра".
Этот дескриптор можно получить с помощью функции SHRegOpenUSKey.
pwzSubKey
ТБD
[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 или более поздняя) |