Share via


IBackgroundCopyFile2::GetFileRanges-Methode (bits2_0.h)

Ruft die Bereiche ab, die Sie aus der Remotedatei herunterladen möchten.

Syntax

HRESULT GetFileRanges(
  [in, out] DWORD         *RangeCount,
  [out]     BG_FILE_RANGE **Ranges
);

Parameter

[in, out] RangeCount

Anzahl der Elemente in Bereichen.

[out] Ranges

Array von BG_FILE_RANGE Strukturen, die die bereiche angeben, die heruntergeladen werden sollen. Wenn Sie fertig sind, rufen Sie die CoTaskMemFree-Funktion auf, um Bereiche frei zu geben.

Rückgabewert

Diese Methode gibt die folgenden Rückgabewerte sowie andere rückgabewerte zurück.

Rückgabecode Beschreibung
S_OK
Erfolg
S_FALSE
Es wurden keine Bereiche angegeben, oder der Auftrag ist ein Upload- oder Upload-Antwortauftrag. RangeCount ist auf Null und Ranges auf NULL festgelegt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista, Windows XP mit SP2, KB842773 unter Windows Server 2003 und Windows XP
Unterstützte Mindestversion (Server) Windows Server 2008, Windows Server 2003 mit SP1
Zielplattform Windows
Kopfzeile bits2_0.h (Bits.h einschließen)
Bibliothek Bits.lib
DLL BitsPrx3.dll

Weitere Informationen

BG_FILE_RANGE

IBackgroundCopyFile2

IBackgroundCopyJob3::AddFileWithRanges