ObjectContext

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

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

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_FAIL のほか、次の値を返すことがあります。

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

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

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

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_FAIL のほか、次の値を返すことがあります。

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

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

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

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_FAIL のほか、次の値を返すことがあります。

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

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

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

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_FAIL のほか、次の値を返すことがあります。

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

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

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

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_FAIL のほか、次の値を返すことがあります。

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

現在のオブジェクトがトランザクション内で実行されているかどうかを示します。(ObjectContext.IsInTransaction)

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_FAIL のほか、次の値を返すことがあります。

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

現在のオブジェクトに対してセキュリティが有効になっているかどうかを示します。

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_FAIL のほか、次の値を返すことがあります。

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

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

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_FAIL のほか、次の値を返すことがあります。

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

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

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

名前付きコンテキストオブジェクトプロパティの数を取得します。

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、および S_OK を返すことがあります。

名前付きプロパティを取得します。

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、および S_OK を返すことがあります。

名前付きコンテキストオブジェクトプロパティの列挙子を取得します。

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、および S_OK を返すことがあります。

現在のオブジェクトのコンテキストのセキュリティオブジェクトを取得します。

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、および S_OK を返すことがあります。

現在のオブジェクトのコンテキストのコンテキスト情報オブジェクトを取得します。

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、および S_OK を返すことがあります。