WdCancelRemoteDelete
削除操作におけるクライアントの待機のキャンセルをシグナルします。 導入バージョン: RIT 0.0.13-preview。構文
パラメーター
_In_ cancellationHandleType: WdCancellationHandle WdCreateCancellationHandle で作成し、WdDeleteRemoteFiles に渡されたキャンセル ハンドル。このハンドルにシグナルを送ると、クライアントの待機のキャンセルが要求されます。
戻り値
Type: HRESULT 成功した場合はS_OK を返します。それ以外の場合はエラー コードを返します。
解説
ブロッキングされている WdDeleteRemoteFiles 呼び出しのキャンセルをシグナルするには、別のスレッドからWdCancelRemoteDelete を呼び出します。WdCancelRemoteDelete は非ブロッキング関数です。WdDeleteRemoteFiles がシグナルを検知すると、待機を停止し、エンドポイントでの完了を確認せずに S_OK を返します。
キャンセルが検知された場合も通常どおり完了した場合も S_OK が返されるため、キャンセルする可能性のある呼び出し元は、戻り値だけでは結果を判断できません。この 2 つを区別する必要がある場合 (たとえば、ユーザーが開始したキャンセルの後にエラー メッセージを表示しないようにしたり、再試行をスキップしたりする場合) は、独自のコードでキャンセル状態を追跡してください。
キャンセルしても、エンドポイントで既に開始された削除は停止されず、独立して続行されます。また、既に削除された項目は復元されません。