Use the IBackgroundCopyJob2 interface to retrieve reply data from an upload-reply job, determine the progress of the reply data transfer to the client, request command line execution, and provide credentials for proxy and remote server authentication requests.
The IBackgroundCopyJob2 interface inherits from the IBackgroundCopyJob interface.
To get an
IBackgroundCopyJob2 interface pointer, call the IBackgroundCopyJob::QueryInterface method using
__uuidof(IBackgroundCopyJob2) for the interface identifier. Use the
IBackgroundCopyJob2 interface pointer to call both the
The IBackgroundCopyJob2 interface has these methods.
|IBackgroundCopyJob2::GetNotifyCmdLine||Retrieves the program to execute when the job enters the error or transferred state.|
|IBackgroundCopyJob2::GetReplyData||Retrieves an in-memory copy of the reply data from the server application. Call this method only if the job's type is BG_JOB_TYPE_UPLOAD_REPLY and its state is BG_JOB_STATE_TRANSFERRED.|
|IBackgroundCopyJob2::GetReplyFileName||Retrieves the name of the file that contains the reply data from the server application. Call this method only if the job type is BG_JOB_TYPE_UPLOAD_REPLY.|
|IBackgroundCopyJob2::GetReplyProgress||Retrieves progress information related to the transfer of the reply data from an upload-reply job.|
|IBackgroundCopyJob2::RemoveCredentials||Removes credentials from use. The credentials must match an existing target and scheme pair that you specified using the IBackgroundCopyJob2::SetCredentials method. There is no method to retrieve the credentials you have set.|
|IBackgroundCopyJob2::SetCredentials||Specifies the credentials to use for a proxy or remote server user authentication request.|
|IBackgroundCopyJob2::SetNotifyCmdLine||Specifies a program to execute if the job enters the BG_JOB_STATE_ERROR or BG_JOB_STATE_TRANSFERRED state. BITS executes the program in the context of the user who called this method.|
|IBackgroundCopyJob2::SetReplyFileName||Specifies the name of the file to contain the reply data from the server application. Call this method only if the job's type is BG_JOB_TYPE_UPLOAD_REPLY.|
|Minimum supported client||Windows Vista|
|Minimum supported server||Windows Server 2003|
|Header||bits1_5.h (include Bits.h)|
|Redistributable||BITS 1.5 on Windows XP|