IBackgroundCopyJob2::SetReplyFileName メソッド (bits1_5.h)
サーバー アプリケーションからの応答データを格納するファイルの名前を指定します。 ジョブの種類がBG_JOB_TYPE_UPLOAD_REPLY場合にのみ、このメソッドを呼び出 します。
構文
HRESULT SetReplyFileName(
[in] LPCWSTR ReplyFileName
);
パラメーター
[in] ReplyFileName
応答ファイルへの完全なパスを含む Null で終わる文字列。 ReplyFileNamePathSpec が NULL または空の文字列の場合、BITS によってファイル名が生成されます。 パスまたはファイル名にワイルドカードを使用することはできません。また、パス内のディレクトリが存在する必要があります。 パスは、null ターミネータを含めず、MAX_PATHに制限されます。 ユーザーには、ディレクトリに書き込むアクセス許可が必要です。 BITS は NTFS ストリームをサポートしていません。 セッション固有のネットワーク ドライブを使用する代わりに、UNC パス (\server\share\path\file など) を使用します。 \を含めないでください。 パス内のプレフィックス。
戻り値
このメソッドは、次の HRESULT 値と他の値を返します。
| リターン コード | 説明 |
|---|---|
|
応答データを格納するファイルの名前が正常に指定されました。 |
|
BITS がクライアントへの応答の転送を開始した後で、応答ファイル名を変更することはできません。 状態がBG_JOB_STATE_TRANSFERRINGで、BG_JOB_REPLY_PROGRESS構造体のBytesTotal メンバーがBG_SIZE_UNKNOWNされていない場合、BITS はクライアントに応答を転送します。 |
|
ユーザーには、クライアント上の指定されたディレクトリに書き込む権限がありません。 |
|
応答ファイル名が無効であるか、 MAX_PATHを超えています。 |
注釈
IBackgroundCopyJob::Resume メソッドを初めて呼び出す前に SetReplyFileName メソッドを呼び出さない場合、BITS によってファイル名が生成されます。
BITS でファイル名が生成された場合、応答ファイルはローカル アップロード ファイルと同じディレクトリに書き込まれます。
BITS がサーバー アプリケーションからの応答のダウンロードを開始する前 に、いつでも SetReplyFileName メソッドを呼び出すことができます。ダウンロードが開始された場合、メソッドは失敗します。
応答ファイルは、 IBackgroundCopyJob::Complete メソッドを呼び出した後にクライアントで使用できます。 Complete メソッドを呼び出す前に応答データを取得するには、IBackgroundCopyJob2::GetReplyData メソッドを呼び出します。
サーバー アプリケーションが応答を提供しなかった場合、ファイルは空です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2003 |
| 対象プラットフォーム | Windows |
| ヘッダー | bits1_5.h (Bits.h を含む) |
| Library | Bits.lib |
| [DLL] | BitsPrx2.dll |
| 再頒布可能パッケージ | Windows XP の BITS 1.5 |