IWiaMiniDrv ::d rvDeleteItem, méthode (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 d’état pour cette méthode. Si cette méthode retourne S_OK, la valeur stockée est égale à zéro. Sinon, un code d’erreur spécifique au minidriver est stocké à l’emplacement vers lequel pointe ce paramètre.
Valeur de retour
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 vers laquelle pointe plDevErrVal. La valeur pointée par plDevErrVal peut être convertie en chaîne en appelant IWiaMiniDrv ::d rv ::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 correctement 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.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | wiamindr_lh.h (include Wiamindr.h) |