PRJ_CANCEL_COMMAND_CB

以前のコールバック呼び出しによる操作をキャンセルする必要があることをプロバイダーに通知します。

プロバイダーのコールバックは、呼び出されるたびに CommandId フィールドを持つ callbackData パラメーターを受け取ります。プロバイダーがこのコールバックの実装を提供する場合は、非同期に処理するコールバック、すなわち HRESULT_FROM_WIN32(ERROR_IO_PENDING) を返したものの PrjCompleteCommand の呼び出しによってまだ完了させていないコールバックの CommandId の値を記録しておく必要があります。プロバイダーがこのコールバックを受け取った場合、それは以前のコールバックの呼び出し要因となった I/O が、明示的に、またはその I/O を発行したスレッドが終了したことによってキャンセルされたことを示します。プロバイダーは、CommandId で識別されるコールバック呼び出しの処理をできるだけ速やかにキャンセルする必要があります。

このコールバックの callbackData に含まれる CommandId に対して PrjCompleteCommand を呼び出してもエラーにはなりませんが、CommandId で識別されるコールバック呼び出しの要因となった I/O は既に終了しているため、何も行われません。

ProjFS は、特定の CommandId に対する PRJ_CANCEL_COMMAND_CB を、キャンセル対象のコールバックが呼び出された後にのみ呼び出します。ただし、複数のワーカースレッドを同時に実行できるようにプロバイダーが構成されている場合、キャンセルと元の呼び出しが同時に実行されることがあります。プロバイダーはこの状況に対処できる必要があります。

このコールバックは省略可能です。プロバイダーがこのコールバックの実装を提供しない場合、他のコールバックはいずれもキャンセルできません。プロバイダーはすべてのコールバックを同期的に処理します。