Share via

BINDSPEED 列挙 (oleidl.h)

  • [アーティクル]

呼び出し元がオブジェクトへのバインドを待機するおおよその時間を示します。

構文

typedef enum tagBINDSPEED {
  BINDSPEED_INDEFINITE = 1,
  BINDSPEED_MODERATE = 2,
  BINDSPEED_IMMEDIATE = 3
} BINDSPEED;

定数

 
BINDSPEED_INDEFINITE
値: 1
バインド操作に時間制限はありません。
BINDSPEED_MODERATE
値: 2
バインディング操作は、中程度の時間で完了する必要があります。

このフラグが指定されている場合、 IOleItemContainer::GetObject の実装は、次のトーンが true でない限り、MK_E_EXCEEEDEDDEADLINEを返す必要があります。


  • オブジェクトは既に実行中の状態です。

  • オブジェクトは擬似オブジェクト (スプレッドシート内のセル範囲やワード プロセッサの文字範囲など、項目コンテナーの内部にあるオブジェクト) です。

  • オブジェクトはインプロセス サーバーでサポートされています (そのため、読み込まれると常に実行中の状態になります)。 この場合、 GetObject は指定されたオブジェクトを読み込み、 OleIsRunning 関数がオブジェクトが実行されていることを示す場合は、正常にを返します。

BINDSPEED_IMMEDIATE
値: 3
呼び出し元は短時間だけ待機します。 この場合、バインド操作は、オブジェクトが既に実行中の状態であるか、擬似オブジェクトでない限り、MK_E_EXCEEEDEDDEADLINEを返す必要があります。

注釈

システム提供の項目モニカーの実装は、 IOleItemContainer::GetObject のプライマリ呼び出し元です。 指定する BINDSPEED 値は、モニカー操作の呼び出し元によって指定された期限によって異なります。

期限は、モニカー操作に渡されるバインド コンテキストのBIND_OPTS構造体の dwTickCountDeadline フィールドに格納されます。 この値は、 GetTickCount 関数の戻り値に基づいています。 dwTickCountDeadline が 0 で期限がないことを示す場合、アイテム モニカーの実装はBINDSPEED_INDEFINITEを指定します。 (これは、CreateBindCtx 関数によって返されるバインド コンテキストの既定の dwTickCountDeadline 値です)。dwTickCountDeadline と GetTickCount によって返される値の差が 2500 を超える場合、項目モニカーの実装ではBINDSPEED_MODERATEを指定します。 差が 2500 未満の場合、項目モニカーの実装では BINDSPEED_IMMEDIATE が指定されます。

GetObject の実装では、バインド期限のショートカット近似として BINDSPEED 値を使用することも、IBindCtx インスタンス パラメーターを使用して正確な期限を決定することもできます。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header oleidl.h

こちらもご覧ください

BIND_OPTS

Ibindctx

IOleItemContainer::GetObject