IDeliveryOptimizationJob::AddFileWithRanges-Methode
Fügt einem Downloadauftrag eine Datei hinzu und gibt die Bereiche der Datei an, die Sie herunterladen möchten.
Syntax
HRESULT AddFileWithRanges(
[in] LPCWSTR fileId,
[in] LPCWSTR remoteUrl,
[in] LPCWSTR localName,
[in, optional] DWORD rangeCount,
[in, optional] BG_FILE_RANGE ranges[],
[in, optional] ULONG64 fileSize
);
Parameter
-
fileId [ In]
-
Null terminierte Zeichenfolge, die einen eindeutigen Bezeichner des veröffentlichten Inhalts ist. Bei nicht veröffentlichten Inhalten kann dies eine beliebige eindeutige Zeichenfolge sein, die der Aufrufer zum Identifizieren von Dateien innerhalb eines Auftrags verwenden kann.
-
remoteUrl [ In]
-
Auf NULL endende Zeichenfolge, die den Namen der Datei auf dem Server enthält.
-
localName [ In]
-
Auf NULL endende Zeichenfolge, die den Namen der Datei auf dem Client enthält.
-
rangeCount [ in, optional]
-
Anzahl der Elemente in Bereichen.
-
-Bereiche [ in, optional]
-
Array von mindestens einer BG_FILE_RANGE-Strukturen, die die herunterzuladende Bereiche angeben. Geben Sie keine doppelten oder überlappenden Bereiche an.
-
fileSize [ in, optional]
-
Die Länge der Datei in Bytes. Übergeben Sie DO_UNKNOWN_FILE_SIZE , wenn die Größe der Aufruferanwendung nicht bekannt ist.
Rückgabewert
Diese Methode gibt die folgenden Rückgabewerte sowie andere zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Erfolg. |
|
Der lokale Dateiname ist NULL oder eine leere Zeichenfolge. |
|
Der Benutzer verfügt nicht über die Berechtigung, in das angegebene Verzeichnis auf dem Client zu schreiben. |
|
Einer der Bereiche ist ungültig. InitialOffset ist beispielsweise auf BG_LENGTH_TO_EOFfestgelegt. |
|
Sie können keine doppelten oder überlappenden Bereiche angeben. [!Note] |
|
Der Status des Auftrags kann nicht BG_JOB_STATE_CANCELLED oder BG_JOB_STATE_ACKNOWLEDGEDwerden. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 10, nur Desktop-Apps der Version 1709 [] |
| Unterstützte Mindestversion (Server) |
Windows Server, nur Desktop-Apps der Version 1709 [] |
| Header |
|
| IDL |
|
| Bibliothek |
|
| DLL |
|
| IID |
IID_IDeliveryOptimizationJob ist als EE2584CF-A69C-4848-B633-2649962B3EF7 definiert. |