IBITSExtensionSetup::GetCleanupTaskName メソッド (bitscfg.h)

GetCleanupTaskName メソッドを使用して、仮想ディレクトリに関連付けられているクリーンアップ タスクの名前を取得します。

構文

HRESULT GetCleanupTaskName(
  [out] BSTR *pTaskName
);

パラメーター

[out] pTaskName

仮想ディレクトリに関連付けられているクリーンアップ タスクの名前を含む Null で終わる文字列。 NULL の場合、BITS は仮想ディレクトリのクリーンアップ タスクを作成していません。 完了したら、 SysFreeString 関数を呼び出して pTaskName を解放します。

戻り値

このメソッドは、成功のために S_OK を返します。 それ以外の場合、仮想ディレクトリにタスク名が指定されていない場合、メソッドは S_FALSE を返します。

注釈

仮想ディレクトリを作成し、BITS アップロードに 対して有効にすると 、BITS によって タスク スケジューラに作業項目が追加されます。 作業項目は、タイムアウト期間内に変更されていないジョブを削除することで、12 時間ごとに仮想ディレクトリをクリーンアップします。 タイムアウト期間を指定するには、 BITSSessionTimeout IIS 拡張プロパティを設定します。

pTaskName 名は、Schtasks.exe 実行可能ファイルへの入力パラメーターとして使用します。これを使用して、クリーンアップ タスクのプロパティをスクリプトから変更できます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2003
対象プラットフォーム	Windows
ヘッダー	bitscfg.h
[DLL]	BitsMgr.dll
再頒布可能パッケージ	Windows XP の BITS 1.5

こちらもご覧ください

IBITSExtensionSetup::EnableBITSUploads

IBITSExtensionSetup::GetCleanupTask