IMoniker::Enum メソッド (objidl.h)

  • [アーティクル]

複合モニカーのコンポーネントの列挙子へのポインターを取得します。

構文

HRESULT Enum(
  [in]  BOOL         fForward,
  [out] IEnumMoniker **ppenumMoniker
);

パラメーター

[in] fForward

TRUE の場合、モニカーを左から右に列挙します。 FALSE の場合は、右から左に列挙します。

[out] ppenumMoniker

モニカーの列挙子オブジェクトへのインターフェイス ポインターを受け取る IEnumMoniker ポインター変数へのポインター。 成功した場合、実装では列挙子オブジェクトで AddRef を呼び出す必要があります。 Release を呼び出すのは呼び出し元の責任です。 エラーが発生した場合、またはモニカーに列挙可能なコンポーネントがない場合、実装は *ppenumMoniker を NULL に設定 します。

戻り値

このメソッドは、E_OUTOFMEMORY、E_UNEXPECTED、およびS_OKの標準戻り値を返すことができます。

注釈

このメソッドは、モニカーのコンポーネントを列挙できる列挙子への IEnumMoniker ポインターを指定する必要があります。 たとえば、汎用複合モニカーの IMoniker::Enum メソッドの実装では、複合を構成する個々のモニカーを決定できる列挙子が作成されますが、ファイル モニカーの IMoniker::Enum メソッドは、パス内の各コンポーネントを表すモニカーを返す列挙子を作成します。

呼び出し元へのメモ

複合モニカーを構成するコンポーネントを調べるには、このメソッドを呼び出します。

実装者へのメモ

新しいモニカー クラスに認識可能な内部構造がない場合、このメソッドの実装は単に S_OKを返し、 ppenumMoniker を NULL に設定できます。

実装固有の注意事項

実装 メモ
アンチモニカー このメソッドは、S_OKを返し、 ppenumMoniker を NULL に設定します。
クラス モニカー このメソッドは、S_OKを返し、 ppenumMoniker を NULL に設定します。
ファイル モニカー このメソッドは、S_OKを返し、 ppenumMoniker を NULL に設定します。
汎用複合モニカー 成功した場合、このメソッドは S_OKを返し、複合を構成するコンポーネント モニカーを列挙する列挙子を返します。それ以外の場合、メソッドは E_OUTOFMEMORYを返します。
アイテム モニカー このメソッドは、S_OKを返し、 ppenumMoniker を NULL に設定します。
OBJREF モニカー このメソッドは、S_OKを返し、 ppenumMoniker を NULL に設定します。
ポインター モニカー このメソッドは、E_NOTIMPLを返します。
URL モニカー このメソッドは、S_OKを返し、 ppenumMoniker を NULL に設定します。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー objidl.h

こちらもご覧ください

IEnumMoniker

Imoniker