Share via

IBackgroundCopyFile3::GetTemporaryName-Methode (bits3_0.h)

  • Artikel

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
S_OK
 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:

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

Weitere Informationen

IBackgroundCopyCallback2::FileTransferred

IBackgroundCopyFile3