[函式探索可用於需求一節中指定的作業系統。 後續版本可能會變更或無法使用。]
根據類別和子類別移除指定的函式實例。
語法
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傳回。
傳回值
可能的傳回值包括但不限於下列各項。
| 傳回碼/值 | 描述 |
|---|---|
|
已成功完成命令。 |
|
pszCategoryIdentity的值無效。 |
|
方法無法配置執行這項作業所需的記憶體。 |
|
使用者沒有足夠的存取權限可執行要求的動作。 |
|
pszCategory或pszSubCategory的值未知。 |
備註
需要變更 HKEY_LOCAL_MACHINE\SYSTEM 登錄機碼的存取權限,才能使用登錄提供者新增或移除函式實例, (系統管理員或 Power User 存取層級) 。 使用者必須具有系統管理員存取權,才能移除整個函式實例。
注意 所有提供者都不支援這個方法。
需求
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | functiondiscoveryapi.h |
| Dll | FunDisc.dll |