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

[アーティクル]
08/25/2023

モニカーを最も単純な形式に減らします。

構文

HRESULT Reduce(
  [in]      IBindCtx *pbc,
  [in]      DWORD    dwReduceHowFar,
  [in, out] IMoniker **ppmkToLeft,
  [out]     IMoniker **ppmkReduced
);

パラメーター

[in] pbc

このバインド操作で使用されるバインドコンテキスト上の IBindCtx インターフェイスへのポインター。バインドコンテキストは、バインドプロセス中にバインドされたオブジェクトをキャッシュし、バインドコンテキストを使用するすべての操作に適用されるパラメーターを含み、モニカー実装がその環境に関する情報を取得する手段を提供します。

[in] dwReduceHowFar

このモニカーをどの程度縮小するかを指定します。このパラメーターは、 MKRREDUCE 列挙の値のいずれかである必要があります。

[in, out] ppmkToLeft

エントリで、このモニカーの左側にあるモニカーへのインターフェイスポインターを含む IMoniker ポインター変数へのポインター。このパラメーターは、複合モニカーのさまざまなコンポーネント間の連携を可能にするために、主にモニカー実装者によって使用されます。モニカークライアントは通常 、NULL を渡すことができます。

戻り値の場合、*ppmkToLeft は通常 NULL に設定され、元のモニカーが左側に変更されていないことを示します。まれな状況では、*ppmkToLeft はモニカーを示し、左側の前のモニカーを無視し、*ppmkToLeft を介して返されるモニカーが置き換えであることを示します。このような状況では、実装では、このモニカーの左側にある古いモニカーで Release を呼び出し、返された新しいモニカーで AddRef を呼び出す必要があります。呼び出し元は後で解放する必要があります。エラーが発生した場合、実装はインターフェイスポインターを変更せずに残すか 、NULL に設定できます。

[out] ppmkReduced

このモニカーの縮小形式へのインターフェイスポインターを受け取る IMoniker ポインター変数へのポインター。エラーが発生した場合、またはこのモニカーが何も減らされない場合は NULL になる可能性があります。このモニカーを減らすことができない場合、*ppmkReduced はこのモニカーに設定され、戻り値はMK_S_REDUCED_TO_SELF。 *ppmkReduced が NULL 以外の場合、実装では新しいモニカーで AddRef を呼び出す必要があります。 Release を呼び出すのは呼び出し元の責任です。 (これは、*ppmkReduced がこのモニカーに設定されている場合でも当てはまります)。

戻り値

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

リターンコード	説明
S_OK	メソッドは正常に完了しました。
MK_S_REDUCED_TO_SELF	このモニカーをこれ以上減らすことはできなかったため、 ppmkReduced はこのモニカーを示します。
MK_E_EXCEEDEDDEADLINE	バインドコンテキストの BIND_OPTS 構造体で指定された制限時間内に操作を完了できませんでした。

注釈

このメソッドは、次の用途を対象としています。

新しい種類のモニカークラスとして、ユーザー定義マクロまたはエイリアスの構築を有効にします。縮小すると、マクロが評価されるモニカーが返されます。
移動中にデータを追跡する一種のモニカーの構築を有効にします。縮小すると、現在の場所にあるデータのモニカーが返されます。
ファイル名に依存しないファイルにアクセスする識別子ベースのメソッドをサポートするファイルシステムの場合。ファイルモニカーは、これらの識別子のいずれかを含むモニカーに減らすことができます。

dwReduceHowFar パラメーターで渡される MKRREDUCE フラグの目的は、表示名がユーザーに認識可能なフォームにモニカーをプログラムで減らす機能を提供することです。たとえば、ファイルシステム内のパス、ワープロドキュメント内のブックマーク、スプレッドシート内の範囲名はすべてユーザーが認識できます。これに対し、モニカーにカプセル化されたマクロまたはエイリアスは、ユーザーには認識できません。

呼び出し元へのメモ

上記のシナリオは、現在、システム提供のモニカークラスによって実装されていません。

縮小モニカーは最も具体的な形式であるため、IMoniker::IsEqual メソッドを使用して 2 つのモニカーを比較する前に Reduce を呼び出す必要があります。 IsEqual は、縮小する前に 2 つのモニカーに対してS_FALSEを返し、減らした後にS_OKを返す場合があります。

実装者へのメモ

現在のモニカーを減らすことができる場合、実装ではモニカーをインプレースで減らしてはなりません。代わりに、現在のモニカーの縮小状態を表す新しいモニカーを返す必要があります。この方法では、呼び出し元は引き続き、非誘導モニカーを使用するオプションを持っています (たとえば、そのコンポーネントを列挙します)。実装では、少なくとも要求される限りモニカーを減らす必要があります。

実装固有の注意事項

実装	メモ
アンチモニカー	このメソッドは、MK_S_REDUCED_TO_SELFを返し、同じモニカーを返します。
クラスモニカー	このメソッドは、MK_S_REDUCED_TO_SELFを返し、同じモニカーを返します。
ファイルモニカー	このメソッドは、MK_S_REDUCED_TO_SELFを返し、同じモニカーを返します。
汎用複合モニカー	このメソッドは、各コンポーネントモニカーに対して Reduce を再帰的に呼び出します。いずれかのコンポーネントがそれ自体を減らす場合、メソッドは S_OKを返し、縮小されたコンポーネントの複合を返します。減少が発生しなかった場合、メソッドは同じモニカーを返し、MK_S_REDUCED_TO_SELFを返します。
アイテムモニカー	このメソッドは、MK_S_REDUCED_TO_SELFを返し、同じモニカーを返します。
OBJREF モニカー	このメソッドは、MK_S_REDUCED_TO_SELFを返し、同じモニカーを返します。
ポインターモニカー	このメソッドは、MK_S_REDUCED_TO_SELFを返し、同じモニカーを返します。
URL モニカー	このメソッドは、MK_S_REDUCED_TO_SELFを返し、同じモニカーを返します。

要件

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

こちらもご覧ください

Imoniker

次の方法で共有