IObjectContext

現在のオブジェクトのコンテキストへのアクセスを提供します。オブジェクトのコンテキストは、主にトランザクションを扱う場合や、オブジェクトのセキュリティを扱う場合に使用されます。(IObjectContext)

他の COM オブジェクトと同様に、IObjectContext オブジェクトの使用を終えたら、ローカル変数である場合を除き、これを解放する必要があります。

現在のオブジェクトのコンテキストを使用してオブジェクトを作成します。(IObjectContext.CreateInstance)

このメソッドは次の値を返すことがあります。

CreateInstance は COM オブジェクトを作成します。ただし、そのオブジェクトがコンテキストを持つのは、そのコンポーネントが COM+ に登録されている場合のみです。

CreateInstance を使用してオブジェクトを作成すると、新しいオブジェクトのコンテキストは、現在のオブジェクトの IObjectContext と、新しいオブジェクトのコンポーネントの宣言的プロパティから導出されます。新しいオブジェクトは常に、それを作成したオブジェクトと同じアクティビティ内で実行されます。現在のオブジェクトがトランザクションを持っている場合、新しいオブジェクトのコンポーネントのトランザクション属性によって、新しいオブジェクトがそのトランザクションのスコープ内で実行されるかどうかが決まります。

コンポーネントのトランザクション属性の設定がトランザクションを必須とする、またはトランザクションをサポートするもののいずれかである場合、新しいオブジェクトは作成元のトランザクションを継承します。コンポーネントのトランザクション属性が新しいトランザクションを必須とする場合、COM+ は新しいオブジェクトのために新しいトランザクションを開始します。コンポーネントのトランザクション属性がトランザクションをサポートしない場合、新しいオブジェクトはどのトランザクションの下でも実行されません。

CreateInstance は常に、新しくインスタンス化されたオブジェクト上の IUnknown インターフェイスを返します。返された値は、新しいオブジェクトと通信するために使用したいインターフェイスへ直ちにキャストする必要があります。riid パラメーターに渡すインターフェイス ID は、返された値をキャストする先のインターフェイスと同じである必要はありませんが、インスタンス化するオブジェクトが実装しているインターフェイスでなければなりません。

オブジェクトが実行されているトランザクションをコミットできること、および現在実行中のメソッド呼び出しから戻る際にオブジェクトを非アクティブ化すべきであることを宣言します。

このメソッドは次の値を返すことがあります。

オブジェクトは、SetComplete を呼び出したメソッドから戻る際に自動的に非アクティブ化されます。オブジェクトが自動トランザクションのルートである場合、COM+ はそのトランザクションのコミットを試みます。ただし、そのトランザクションに参加していたいずれかのオブジェクトが SetAbort を呼び出していた場合、または DisableCommit を呼び出した後に EnableCommit や SetComplete をその後呼び出していない場合、トランザクションはアボートされます。

オブジェクトがメソッド呼び出しから戻った後に状態を保持する必要がない場合は、SetComplete を呼び出し、戻り次第自動的に非アクティブ化されてリソースを回収できるようにするべきです。

オブジェクトが実行されているトランザクションをアボートしなければならないこと、および現在実行中のメソッド呼び出しから戻る際にオブジェクトを非アクティブ化すべきであることを宣言します。

このメソッドは次の値を返すことがあります。

オブジェクトは、SetAbort を呼び出したメソッドから戻る際に自動的に非アクティブ化されます。オブジェクトが自動トランザクションのルートである場合、COM+ はそのトランザクションをアボートします。オブジェクトがトランザクション対応であるものの自動トランザクションのルートではない場合、それが参加しているトランザクションはアボートが確定します。

エラーハンドラー内で SetAbort を呼び出すことで、エラーが発生したときにトランザクションが確実にアボートされるようにできます。また、メソッドの冒頭で SetAbort を呼び出しておくことで、予期しない戻りが発生した場合にオブジェクトが早まってコミットされるのを防ぎ、その後すべてが正常に進んだ場合には、メソッドが戻る直前に SetComplete を呼び出すこともできます。

オブジェクトの処理が必ずしも完了しているわけではないが、そのトランザクションによる更新は一貫した状態にあり、現在の形式でコミット可能であることを宣言します。

このメソッドは次の値を返すことがあります。

オブジェクトが EnableCommit を呼び出すと、参加しているトランザクションのコミットを許可しますが、SetComplete または SetAbort を呼び出すまで、あるいはトランザクションが完了するまで、クライアントからの呼び出しをまたいで内部状態を保持します。

EnableCommit は、オブジェクトがアクティブ化されたときの既定の状態です。したがって、オブジェクトが次のクライアントからの呼び出しに備えて内部状態を保持したい場合を除き、メソッドから戻る前に常に SetComplete または SetAbort を呼び出すべきです。

オブジェクトのトランザクションによる更新が一貫しない状態にあり、現在の状態ではコミットできないことを宣言します。

このメソッドは次の値を返すことがあります。

DisableCommit メソッドを使用すると、ステートフルなオブジェクトにおいて、メソッド呼び出しの間にトランザクションが早まってコミットされるのを防ぐことができます。オブジェクトが DisableCommit を呼び出すと、その処理が一貫しておらず、クライアントからのさらなるメソッド呼び出しを受け取るまで処理を完了できないことを示します。また、その処理を実行するために状態を保持する必要があることも示します。これにより、COM+ がメソッド呼び出しから戻る際にオブジェクトを非アクティブ化してそのリソースを回収するのを防ぎます。オブジェクトが DisableCommit を呼び出した後、そのオブジェクトが EnableCommit または SetComplete を呼び出す前にクライアントがトランザクションをコミットしようとすると、トランザクションはアボートします。

たとえば、データベースを更新する GeneralLedger コンポーネントがあるとします。クライアントは、さまざまな勘定に仕訳を記帳するために GeneralLedger オブジェクトに対して複数回の呼び出しを行います。最後のメソッド呼び出しが戻る時点で借方と貸方が一致していなければならず、そうでなければトランザクションをアボートしなければならない、という整合性制約があります。GeneralLedger オブジェクトには初期化メソッドがあり、クライアントはそこで、これから行う呼び出しのシーケンスをオブジェクトに通知し、GeneralLedger オブジェクトは DisableCommit を呼び出します。オブジェクトは呼び出しの間に状態を保持するため、シーケンスの最後の呼び出しが行われた後に、処理のコミットを許可する前に整合性制約が満たされていることを確認できます。

オブジェクトがトランザクション内で実行されているかどうかを示します。

現在のオブジェクトがトランザクション内で実行されている場合、戻り値は TRUE です。そうでない場合は FALSE です。

このメソッドを使用すると、トランザクションを必要とするオブジェクトがトランザクションなしで実行されることが決してないようにすることができます。たとえば、トランザクションを必要とするコンポーネントがコンポーネント サービス管理ツールで不適切に構成されている場合、このメソッドを使用してオブジェクトがトランザクションを持たないことを判定できます。その後、問題をユーザーに知らせるためにエラーを返したり、適切な処置を行ったりできます。

現在のオブジェクトに対してセキュリティが有効かどうかを示します。COM+ のセキュリティは、オブジェクトがクライアントのプロセス内で実行されている場合を除き、有効です。

このオブジェクトに対してセキュリティが有効な場合、戻り値は TRUE です。そうでない場合は FALSE です。

COM+ 環境では、サーバー アプリケーションおよびライブラリ アプリケーションはロールベースのセキュリティを使用できます。IsSecurityEnabled は、アプリケーションがロールベースのセキュリティを使用し、そのアプリケーションとメソッドを呼び出した特定のコンポーネントの両方でロールベースのセキュリティが有効になっている場合に TRUE を返します。

MTS 2.0: MTS 2.0 では、MTS ライブラリ アプリケーションはロールベースのセキュリティを使用できないため、現在のオブジェクトがライブラリ アプリケーション内で実行されている場合、このメソッドは常に FALSE を返します。ただし、COM+ 環境では、ライブラリ アプリケーションは任意でロールベースのセキュリティを使用できます。

オブジェクトの直接の呼び出し元が、指定されたロールに(直接またはグループの一員として)属しているかどうかを示します。(IObjectContext.IsCallerInRole)

このメソッドは次の値を返すことがあります。

このメソッドは、現在実行中のメソッドの直接の呼び出し元が特定のロールに関連付けられているかどうかを判定するために使用します。ロールとは、特定の COM+ アプリケーション内のすべてのコンポーネントに対する特定のアクセス許可を持つユーザーまたはユーザー グループを表す記号的な名前です。開発者はコンポーネントを作成する際にロールを定義し、ロールはデプロイ時に個々のユーザーまたはグループにマップされます。

IsCallerInRole は、現在実行中のメソッドの直接の呼び出し元にのみ適用されます。(直接の呼び出し元とは、現在のサーバー プロセスを呼び出しているプロセスのことです。これはベース クライアント プロセスの場合もサーバー プロセスの場合もあります。) IsCallerInRole は、現在のメソッドが呼び出された呼び出しシーケンスを開始したプロセスや、そのシーケンス内の他の呼び出し元には適用されません。

IsCallerInRole は、それを呼び出したオブジェクトがクライアントのプロセス内で実行されている場合に TRUE を返すため、IsCallerInRole を呼び出す前に IsSecurityEnabled を呼び出すのが賢明です。セキュリティが有効でない場合、IsCallerInRole は正確な結果を返しません。