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 的值未知。

备注

若要使用注册表提供程序 (管理员或 Power User 访问级别) 添加或删除函数实例，需要具有更改 HKEY_LOCAL_MACHINE\SYSTEM 注册表项的访问权限。 用户必须具有管理员访问权限才能在系统范围内删除函数实例。

注意 并非所有提供程序都支持此方法。
 

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 functiondiscoveryapi.h
DLL FunDisc.dll

请参阅

IFunctionDiscovery