IBackgroundCopyJob2-Schnittstelle (bits1_5.h)
Verwenden Sie die IBackgroundCopyJob2-Schnittstelle , um Antwortdaten aus einem Upload-Antwort-Auftrag abzurufen, den Fortschritt der Antwortdatenübertragung an den Client zu ermitteln, die Befehlszeilenausführung anzufordern und Anmeldeinformationen für Proxy- und Remoteserverauthentifizierungsanforderungen bereitzustellen.
Die IBackgroundCopyJob2-Schnittstelle erbt von der IBackgroundCopyJob-Schnittstelle .
Um einen IBackgroundCopyJob2-Schnittstellenzeiger abzurufen, rufen Sie die IBackgroundCopyJob::QueryInterface-Methode mit __uuidof(IBackgroundCopyJob2) für den Schnittstellenbezeichner auf. Verwenden Sie den IBackgroundCopyJob2-Schnittstellenzeiger , um sowohl die Methoden IBackgroundCopyJob als auch IBackgroundCopyJob2 aufzurufen.
Vererbung
Die IBackgroundCopyJob2-Schnittstelle erbt von IBackgroundCopyJob. IBackgroundCopyJob2 verfügt auch über folgende Membertypen:
Methoden
Die IBackgroundCopyJob2-Schnittstelle verfügt über diese Methoden.
| IBackgroundCopyJob2::GetNotifyCmdLine Ruft das Programm ab, das ausgeführt werden soll, wenn der Auftrag in den Fehler- oder übertragenen Zustand wechselt. |
| IBackgroundCopyJob2::GetReplyData Ruft eine In-Memory-Kopie der Antwortdaten aus der Serveranwendung ab. Rufen Sie diese Methode nur auf, wenn der Typ des Auftrags BG_JOB_TYPE_UPLOAD_REPLY und der Status BG_JOB_STATE_TRANSFERRED ist. |
| IBackgroundCopyJob2::GetReplyFileName Ruft den Namen der Datei ab, die die Antwortdaten aus der Serveranwendung enthält. Rufen Sie diese Methode nur auf, wenn der Auftragstyp BG_JOB_TYPE_UPLOAD_REPLY ist. |
| IBackgroundCopyJob2::GetReplyProgress Ruft Statusinformationen im Zusammenhang mit der Übertragung der Antwortdaten aus einem Upload/Antwortauftrag ab. |
| IBackgroundCopyJob2::RemoveCredentials Entfernt Anmeldeinformationen aus der Verwendung. Die Anmeldeinformationen müssen mit einem vorhandenen Ziel- und Schemapaar übereinstimmen, das Sie mit der IBackgroundCopyJob2::SetCredentials-Methode angegeben haben. Es gibt keine Methode zum Abrufen der von Ihnen festgelegten Anmeldeinformationen. |
| IBackgroundCopyJob2::SetCredentials Gibt die Anmeldeinformationen an, die für eine Proxy- oder Remoteserver-Benutzerauthentifizierungsanforderung verwendet werden sollen. |
| IBackgroundCopyJob2::SetNotifyCmdLine Gibt ein Programm an, das ausgeführt werden soll, wenn der Auftrag in den BG_JOB_STATE_ERROR- oder BG_JOB_STATE_TRANSFERRED-Zustand wechselt. BITS führt das Programm im Kontext des Benutzers aus, der diese Methode aufgerufen hat. |
| IBackgroundCopyJob2::SetReplyFileName Gibt den Namen der Datei an, die die Antwortdaten der Serveranwendung enthalten soll. Rufen Sie diese Methode nur auf, wenn der Typ des Auftrags BG_JOB_TYPE_UPLOAD_REPLY ist. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2003 |
| Zielplattform | Windows |
| Kopfzeile | bits1_5.h (Bits.h einschließen) |
| Verteilbare Komponente | BITS 1.5 unter Windows XP |