IBindCtx インターフェイス (objidl.h)
バインド コンテキストへのアクセスを提供します。これは、特定のモニカー バインド操作に関する情報を格納するオブジェクトです。
継承
IBindCtx インターフェイスは、IUnknown インターフェイスから継承されます。 IBindCtx には、次の種類のメンバーもあります。
メソッド
IBindCtx インターフェイスには、これらのメソッドがあります。
| IBindCtx::EnumObjectParam バインド コンテキストの文字列キー付きポインター テーブルのキーを列挙するために使用できるインターフェイスへのポインターを取得します。 |
| IBindCtx::GetBindOptions このバインド コンテキストに格納されているバインド オプションを取得します。 |
| IBindCtx::GetObjectParam バインド コンテキストの文字列キー付きポインター テーブルで、指定したキーに関連付けられているオブジェクトへのインターフェイス ポインターを取得します。 |
| IBindCtx::GetRunningObjectTable このバインド コンテキストが実行されているコンピューターの実行中のオブジェクト テーブル (ROT) へのインターフェイス ポインターを取得します。 |
| IBindCtx::RegisterObjectBound バインド コンテキストにオブジェクトを登録して、バインド コンテキストが解放されるまでオブジェクトがアクティブなままになるようにします。 |
| IBindCtx::RegisterObjectParam バインド コンテキストの文字列キー付きポインター テーブル内の文字列キーにオブジェクトを関連付けます。 |
| IBindCtx::ReleaseBoundObjects RegisterObjectBound の呼び出しによって以前に登録されたすべてのオブジェクトへのすべてのポインターを解放します。 |
| IBindCtx::RevokeObjectBound バインド コンテキストからオブジェクトを削除し、RegisterObjectBound の以前の呼び出しを元に戻します。 |
| IBindCtx::RevokeObjectParam バインド コンテキストの文字列キー付きオブジェクト テーブルから、指定したキーとその関連付けられたポインターを削除します。 キーは、RegisterObjectParam の呼び出しでテーブルに挿入されている必要があります。 |
| IBindCtx::SetBindOptions バインド コンテキストに格納されているバインド パラメーターの新しい値を設定します。 |
注釈
バインド コンテキストには、次の情報が含まれます。
- バインド操作中に変更されないパラメーターのセットを含む BIND_OPTS 構造体。 複合モニカーがバインドされると、各コンポーネントは同じバインド コンテキストを使用するため、複合モニカーの各コンポーネントに同じパラメーターを渡すためのメカニズムとして機能します。
- バインド操作がアクティブ化されたオブジェクトへのポインターのセット。 バインド コンテキストは、これらのバインドされたオブジェクトへのポインターを保持し、読み込まれた状態を維持するため、後続のバインド操作中にオブジェクトが再び必要になった場合に冗長なアクティブ化を排除します。
- バインド操作を開始したプロセスと同じコンピューター上の実行中のオブジェクト テーブル (ROT) へのポインター。 ROT にアクセスする必要があるモニカー実装では、GetRunningObjectTable 関数を使用するのではなく、IBindCtx::GetRunningObjectTable メソッドを使用する必要があります。 これにより、システムの IBindCtx 実装に対する今後の機能強化により、バインド動作を変更できます。
- 文字列キーに関連付けられているインターフェイス ポインターのテーブル。 この機能により、モニカーの実装では、インターフェイス ポインターを既知の文字列の下に格納して、後でバインド コンテキストから取得できるようにします。 たとえば、OLE では、バインド操作中にエラーが発生したオブジェクトへのポインターを格納するために使用できる複数の文字列キー ("ExceededDeadline"、"ConnectManually" など) を定義します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | objidl.h |