Méthode ibackgroundcopyjob :: GetError, méthode

Récupère l’interface d’erreur après qu’une erreur s’est produite.

L’optimisation de la distribution génère un objet d’erreur lorsque l’état du travail est BG_JOB_STATE_ERROR ou BG_JOB_STATE_TRANSIENT_ERROR. Le service ne crée pas d’objet d’erreur lorsqu’un appel à une méthode d’interface IBackgroundCopyXXXX échoue. L’objet d’erreur est disponible jusqu’à ce que l’optimisation de la remise commence à transférer les données (l’état du travail passe à BG_JOB_STATE_TRANSFERRING) pour le travail ou jusqu’à ce que votre application se termine.

Syntaxe

HRESULT GetError(
  [out] IBackgroundCopyError **ppError
);

Paramètres

ppError [ à]

Interface d’erreur qui fournit le code d’erreur, une description de l’erreur et le contexte dans lequel l’erreur s’est produite. Ce paramètre identifie également le fichier transféré au moment où l’erreur s’est produite. Libérez ppError quand vous avez terminé.

Valeur de retour

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

Code de retour Description
S_OK * * * * *
L’objet d’erreur a été généré.
DO_E_ERROR_INFORMATION_UNAVAILABLE
L’interface d’erreur est disponible uniquement lorsqu’une erreur se produit (BG_JOB_STATE_ERROR ou BG_JOB_STATE_TRANSIENT_ERROR) et avant que l’optimisation de la remise commence à transférer des données (BG_JOB_STATE_TRANSFERRING).

Remarques

Le travail est placé dans un état d’erreur en cas d’erreurs irrécupérables. Utilisez l’une des options suivantes pour déterminer si le travail est en erreur :

L’interface IBackgroundCopyError contient des informations que vous utilisez pour déterminer la cause de l’erreur et si le processus de transfert peut se poursuivre. Après avoir déterminé la cause de l’erreur, effectuez l’une des options suivantes :

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows 10, les applications de bureau version 1709 [ uniquement]
Serveur minimal pris en charge
Windows Serveur, version 1709 [ applications de bureau uniquement]
En-tête
Deliveryoptimization. h
MIDL
DeliveryOptimization. idl
Bibliothèque
Dosvc. lib
DLL
Dosvc.dll
IID
IID_IBackgroundCopyJob est défini en tant que 37668D37-507E-4160-9316-26306D150B12

Voir aussi

Méthode ibackgroundcopyjob

IBackgroundCopyCallback::JobError

IBackgroundCopyError

Méthode ibackgroundcopyjob :: GetState