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