Channel.CancelSendFile メソッド (制限付き)
このメソッドは、進行中のファイル転送を取り消します。このメソッドは、アプリケーションに SendFile 許可フラグが設定されている場合のみ使用可能であるため、"制限付き" として扱われます。詳細については、「標準的なアプリケーションと高度なアプリケーション」を参照してください。
VBScript 構文
set myChannel = external.Channel
sub cmdFileCancelButton_OnClick
' ユーザーがファイル転送停止ボタンをクリックしました。
On Error Goto Handler
myChannel.CancelSendFile(myFile)
Exit Sub
:Handler
Document.Write("CancelSendFile が失敗しました。エラー説明:" & err.description)
End Sub
JavaScript 構文
myChannel = window.external.Channel;
function cmdFileCancelButton_OnClick() {
// ユーザーがファイル転送停止ボタンをクリックしました。
try {
myChannel.CancelSendFile(myFile)
}
catch(ex) {
document.write("CancelSendFile が失敗しました。エラー説明:" + ex.description);
}
}
パラメータ
aSendFile
取り消すファイル転送を示す FileInfo 型。
戻り値
戻り値はありません。
解説
アプリケーションに SendFile 許可が設定されていない場合、またはパラメータがファイル転送を示していない場合、例外がスローされます。
実行中のファイル転送が取り消された場合、ファイル キューが設定されていれば、キューの中の次のファイルの転送が開始されます。
キューに転送待ちのファイルが複数ある場合、キューをクリアするには、それぞれのファイルを個別に取り消す必要があります。