Метод IFunctionDiscovery::RemoveInstance (functiondiscoveryapi.h)

[Функция обнаружения доступна для использования в операционных системах, указанных в разделе Требования. Он может быть изменен или недоступен в последующих версиях.]

Удаляет указанный экземпляр функции на основе категории и подкатегории.

Синтаксис

HRESULT RemoveInstance(
  [in] SystemVisibilityFlags enumSystemVisibility,
  [in] const WCHAR           *pszCategory,
  [in] const WCHAR           *pszSubCategory,
  [in] const WCHAR           *pszCategoryIdentity
);

Параметры

[in] enumSystemVisibility

Значение SystemVisibilityFlags , указывающее, удаляется ли экземпляр функции для всей системы или только для текущего пользователя.

[in] pszCategory

Категория экземпляра функции. См. раздел Определения категорий.

[in] pszSubCategory

Подкатегория удаляемого экземпляра функции. См. раздел Определения подкатегорий. Этот параметр может принимать значение NULL.

[in] pszCategoryIdentity

Строка идентификатора экземпляра поставщика. Эта строка возвращается из GetProviderInstanceID.

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

Возможные возвращаемые значения включают, помимо прочего, следующие.

Возвращаемый код или значение	Описание
S_OK	Метод завершился успешно.
E_INVALIDARG	Недопустимое значение pszCategoryIdentity .
E_OUTOFMEMORY	Метод не может выделить память, необходимую для выполнения этой операции.
E_ACCESSDENIED	У пользователя недостаточно разрешений на доступ для выполнения запрошенного действия.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) 0x80070002	Значение pszCategory или pszSubCategory неизвестно.

Комментарии

Разрешение на изменение HKEY_LOCAL_MACHINE\SYSTEM разделов реестра требуется для добавления или удаления экземпляров функций с помощью поставщика реестра (уровни доступа "Администратор" или "Опытный пользователь"). Пользователь должен иметь права администратора, чтобы удалить экземпляр функции по всей системе.

Примечание Этот метод поддерживается не всеми поставщиками.

 

Требования

Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	functiondiscoveryapi.h
DLL	FunDisc.dll

См. также раздел

IFunctionDiscovery