Méthode IDeliveryOptimizationJob::AddFileWithRanges

Ajoute un fichier à un travail de téléchargement et spécifie les plages du fichier à télécharger.

Syntaxe

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
);

Paramètres

fileId [in]

Chaîne terminée par null qui est un identificateur unique du contenu publié. Pour le contenu non publié, il peut s’agir de n’importe quelle chaîne unique que l’appelant peut utiliser pour identifier les fichiers au sein d’un travail.

remoteUrl [in]

Chaîne terminée par null qui contient le nom du fichier sur le serveur.

localName [in]

Chaîne terminée par null qui contient le nom du fichier sur le client.

rangeCount [in, facultatif]

Nombre d’éléments dans Plages.

plages [in, facultatif]

Tableau d’une ou plusieurs structures BG_FILE_RANGE qui spécifient les plages à télécharger. Ne spécifiez pas de plages en double ou qui se chevauchent.

fileSize [in, facultatif]

Taille du fichier en octets. Passez DO_UNKNOWN_FILE_SIZE si la taille n’est pas connue de l’application appelante.

Valeur retournée

Cette méthode retourne les valeurs de retour suivantes, ainsi que d’autres.

Code de retour	Description
S_OK	Réussite.
E_INVALIDARG	Le nom de fichier local est NULL ou chaîne vide.
E_ACCESSDENIED	L’utilisateur n’a pas l’autorisation d’écrire dans le répertoire spécifié sur le client.
DO_E_INVALID_RANGE	L’une des plages n’est pas valide. Par exemple, InitialOffset a la valeur BG_LENGTH_TO_EOF.
DO_E_OVERLAPPING_RANGES	Vous ne pouvez pas spécifier de plages en double ou qui se chevauchent. Note: Les plages sont triées en fonction du décalage de la valeur, et non de la longueur. Si des plages sont entrées qui ont le même décalage, mais sont dans l’ordre inverse, cette erreur est retournée. Par exemple, si 100.5 et 100.0 sont entrés dans cet ordre, vous ne pourrez pas ajouter le fichier au travail.
DO_E_INVALID_STATE	L’état du travail ne peut pas être BG_JOB_STATE_CANCELLED ou BG_JOB_STATE_ACKNOWLEDGED.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1709 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server, version 1709 [applications de bureau uniquement]
En-tête	Deliveryoptimization.h
IDL	DeliveryOptimization.idl
Bibliothèque	Dosvc.lib
DLL	Dosvc.dll
IID	IID_IDeliveryOptimizationJob est défini comme EE2584CF-A69C-4848-B633-2649962B3EF7

Voir aussi

IDeliveryOptimizationJob