Méthode IWiaMiniDrv ::d rvDeleteItem (wiamindr_lh.h)

La méthode IWiaMiniDrv ::d rvDeleteItem supprime l’élément de pilote actuel.

Syntaxe

HRESULT drvDeleteItem(
  BYTE *__MIDL__IWiaMiniDrv0053,
  LONG __MIDL__IWiaMiniDrv0054,
  LONG *__MIDL__IWiaMiniDrv0055
);

Paramètres

__MIDL__IWiaMiniDrv0053

lFlags [in]

Réservé.

__MIDL__IWiaMiniDrv0054

pWiasContext [in]

Pointeur vers un contexte d’élément WIA.

__MIDL__IWiaMiniDrv0055

plDevErrVal [out]

Pointe vers un emplacement de mémoire qui recevra un code status pour cette méthode. Si cette méthode retourne S_OK, la valeur stockée est égale à zéro. Dans le cas contraire, un code d’erreur spécifique au minidriver sera stocké à l’emplacement indiqué par ce paramètre.

Valeur retournée

En cas de réussite, la méthode doit retourner S_OK et effacer la valeur d’erreur de l’appareil pointée par plDevErrVal. Si la méthode échoue, elle doit retourner un code d’erreur COM standard et placer une valeur de code d’erreur spécifique au minidriver dans la mémoire pointée par plDevErrVal. La valeur pointée par plDevErrVal peut être convertie en chaîne en appelant IWiaMiniDrv ::d rvGetDeviceErrorStr.

Remarques

Pour supprimer un élément de pilote, le service WIA appelle la méthode minidriver IWiaMiniDrv ::d rvDeleteItem. Dans cette méthode, le minidriver tente de supprimer l’élément pointé par le paramètre de contexte du service WIA pWiasContext. Si l’élément est supprimé, la méthode retourne S_OK et définit le paramètre de valeur d’erreur de l’appareil plDevErrVal sur zéro. Si une erreur d’appareil se produit, la méthode retourne E_FAIL et une valeur d’erreur spécifique à l’appareil dans le paramètre de valeur d’erreur de l’appareil plDevErrVal.

Avant que le service WIA appelle cette méthode, il vérifie les éléments suivants :

• L’élément n’est pas l’élément racine.

• Si l’élément est un dossier, il n’a pas d’enfants.

• Les droits d’accès de l’élément autorisent la suppression.

Étant donné que le service WIA vérifie ces conditions, il n’est pas nécessaire que le minidriver les vérifie également.

Configuration requise

Voir aussi

IWiaMiniDrv

IWiaMiniDrv ::d rvGetDeviceErrorStr