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 |