IBackgroundCopyFile3::GetTemporaryName-Methode (bits3_0.h)
Ruft den vollständigen Pfad der temporären Datei ab, die den Inhalt des Downloads enthält.
Syntax
HRESULT GetTemporaryName(
[out] LPWSTR *pFilename
);
Parameter
[out] pFilename
Null-beendete Zeichenfolge, die den vollständigen Pfad der temporären Datei enthält. Rufen Sie die CoTaskMemFree-Funktion auf, um ppFileName frei zu geben, wenn Sie fertig sind.
Rückgabewert
Die -Methode gibt die folgenden Rückgabewerte zurück.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Erfolg |
Hinweise
Anwendungen können diese Methode verwenden, um zugriff auf die Daten zu erhalten, bevor der Auftrag abgeschlossen ist. Öffnen Sie die Datei für freigegebenen Schreibzugriff (FILE_SHARE_WRITE). Um zu bestimmen, wie viele Bytes übertragen wurden und zum Lesen verfügbar sind, rufen Sie die IBackgroundCopyFile::GetProgress-Methode auf. Beachten Sie, dass die Statusinformationen wieder auf null festgelegt werden, wenn sich der Zeitstempel der URL ändert.
Öffnen Sie die Datei erst zum Lesen, wenn BITS mit der Übertragung der Datei beginnt. Andernfalls wechselt der Auftrag in den Status vorübergehender Fehler.
Die temporäre Datei ist so lange verfügbar, bis die Anwendung die IBackgroundCopyJob::Complete - oder IBackgroundCopyJob::Cancel-Methode aufruft oder die JobInactivityTimeout-Gruppenrichtlinie abläuft. Sie müssen Ihr Handle für die temporäre Datei freigeben, bevor Sie die Complete - oder Cancel-Methode aufrufen.
Die ACL für die temporäre Datei ist identisch mit der der endgültigen Datei, wenn Complete aufgerufen wird (die ACL wird vom Ordner geerbt).
Um festzustellen, ob BITS die Übertragung der Datei abgeschlossen hat, haben Sie folgende Möglichkeiten:
- Rufen Sie die IBackgroundCopyFile::GetProgress-Methode auf, und vergleichen Sie BytesTransferred mit BytesTotal.
- Implementieren Sie den IBackgroundCopyCallback2::FileTransferred-Rückruf .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | bits3_0.h (Bits.h einschließen) |
| Bibliothek | Bits.lib |