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

インデックス値で指定された優先リストからクラス識別子 (CLSID) を取得します。

構文

HRESULT GetPreferredClsidByIndex(
  [in]  DWORD  pluginType,
  [in]  DWORD  index,
  [out] LPWSTR *selector,
  [out] CLSID  *clsid
);

[in] pluginType

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

[in] index

取得する CLSID の 0 から始まるインデックス。

[out] selector

CLSID に関連付けられているキー名を受け取ります。呼び出し元は、CoTaskMemFree 関数を呼び出して、返された文字列のメモリを解放する必要があります。キー名の形式の詳細については、 IMFPluginControl の「解説」セクションを参照してください。

[out] clsid

指定したインデックス位置にある CLSID を受け取ります。

このメソッドは HRESULT を返します。有効な値を次の表に示しますが、これ以外にもあります。

リターンコード	説明
S_OK	メソッドが成功しました。
E_INVALIDARG	引数が無効です。
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)	index パラメーターが範囲外です。

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