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
S_OK
Erfolg.
E_INVALIDARG
Der lokale Dateiname ist NULL oder eine leere Zeichenfolge.
E_ACCESSDENIED
Der Benutzer verfügt nicht über die Berechtigung, in das angegebene Verzeichnis auf dem Client zu schreiben.
DO_E_INVALID_RANGE
Einer der Bereiche ist ungültig. InitialOffset ist beispielsweise auf BG_LENGTH_TO_EOFfestgelegt.
DO_E_OVERLAPPING_RANGES
Sie können keine doppelten oder überlappenden Bereiche angeben.
[!Note]
Die Bereiche werden nach dem Offset des Werts sortiert, nicht nach der Länge. Wenn Bereiche eingegeben werden, die den gleichen Offset aufweisen, sich aber in umgekehrter Reihenfolge befinden, wird dieser Fehler zurückgegeben. Wenn beispielsweise 100.5 und 100.0 in dieser Reihenfolge eingegeben werden, können Sie die Datei dem Auftrag nicht hinzufügen.

DO_E_INVALID_STATE
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
Deliveryoptimization.h
IDL
DeliveryOptimization.idl
Bibliothek
Dosvc.lib
DLL
Dosvc.dll
IID
IID_IDeliveryOptimizationJob ist als EE2584CF-A69C-4848-B633-2649962B3EF7 definiert.

Siehe auch

IDeliveryOptimizationJob