IMFPluginControl::SetPreferredClsid メソッド (mfobjects.h)

優先リストにクラス識別子 (CLSID) を追加するか、リストから CLSID を削除します。

構文

HRESULT SetPreferredClsid(
  [in] DWORD       pluginType,
  [in] LPCWSTR     selector,
  [in] const CLSID *clsid
);

[in] pluginType

オブジェクトの型を指定する、MF_Plugin_Type 列挙体のメンバー。

[in] selector

CLSID のキー名。キー名の形式の詳細については、 IMFPluginControl の「解説」セクションを参照してください。

[in] clsid

リストに追加する CLSID。このパラメーターが NULL の場合、 セレクター パラメーターで指定されたキー/値エントリがリストから削除されます。

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

優先リストは、呼び出し元のプロセスに対してグローバルです。このメソッドを呼び出しても、他のプロセスのリストには影響しません。

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	mfobjects.h (Mfidl.h を含む)