JOBOBJECT_ASSOCIATE_COMPLETION_PORT 構造体 (winnt.h)

完了ポートをジョブに関連付けるために使用される情報が含まれます。 1 つの完了ポートをジョブに関連付けることができます。

構文

typedef struct _JOBOBJECT_ASSOCIATE_COMPLETION_PORT {
  PVOID  CompletionKey;
  HANDLE CompletionPort;
} JOBOBJECT_ASSOCIATE_COMPLETION_PORT, *PJOBOBJECT_ASSOCIATE_COMPLETION_PORT;

メンバー

CompletionKey

ジョブの代わりにメッセージが送信されるときに PostQueuedCompletionStatus の dwCompletionKey パラメーターで使用する値。

CompletionPort

ジョブの代わりにメッセージが送信されるときに PostQueuedCompletionStatus 関数の CompletionPort パラメーターで使用する完了ポート。

Windows 8、Windows Server 2012、Windows 8.1、Windows Server 2012 R2、Windows 10、Windows Server 2016: 現在の間の関連付けを削除するには NULL を指定します完了ポートとジョブ。

注釈

システムは、特定のイベントが発生したときに、ジョブに関連付けられている I/O 完了ポートにメッセージを送信します。 ジョブが入れ子になっている場合、メッセージは、メッセージをトリガーしたジョブの親ジョブ チェーン内のジョブに関連付けられているすべての I/O 完了ポートに送信されます。 すべてのメッセージは、ジョブが PostQueuedCompletionStatus 関数を呼び出したかのように、ジョブから直接送信されます。

JobObjectNotificationLimitInformation 情報クラスで設定された制限を除き、メッセージは通知としてのみ使用され、完了ポートへの配信は保証されないことに注意してください。 メッセージが完了ポートに到着しなかった場合、必ずしもイベントが発生しなかったとは限りません。 JobObjectNotificationLimitInformation で設定された制限の通知は、完了ポートに到達することが保証されます。

スレッドは 、GetQueuedCompletionStatus 関数を使用して完了ポートを監視してメッセージを取得する必要があります。 スレッドは、次の表に示す GetQueuedCompletionStatus パラメーターの情報を受け取ります。

次のメッセージは、完了ポートに送信できます。 プロセス識別子を返すメッセージの場合、プロセスへのオープン ハンドルを維持しない限り、このプロセスがまだアクティブであるか、識別子がリサイクルされていない (終了後に新しいプロセスに割り当てられている) ことを保証できないことに注意してください。

次の終了コードは、異常終了を示しています。

競合状態が発生する可能性があるため、JOB_OBJECT_MSG_NEW_PROCESSメッセージとJOB_OBJECT_MSG_EXIT_PROCESSメッセージを使用する場合は注意する必要があります。 たとえば、プロセスがジョブ内でアクティブに開始および終了していて、ジョブに完了ポートを割り当てる処理中である場合、完了ポートの関連付け中に状態が変化するプロセスのメッセージが表示されないことがあります。 このため、ジョブが非アクティブな場合は、完了ポートをジョブに関連付けるのが最善です。

要件

こちらもご覧ください

PostQueuedCompletionStatus

QueryInformationJobObject

SetInformationJobObject