DeletePrinterDriverPackage, fonction
Supprime un package de pilotes d’imprimante du magasin de pilotes.
Syntaxe
HRESULT DeletePrinterDriverPackage(
_In_ LPCTSTR pszServer,
_In_ LPCTSTR pszInfPath,
_In_ LPCTSTR pszEnvironment
);
Paramètres
-
pszServer [in]
-
Pointeur vers une chaîne constante terminée par null qui spécifie le nom du serveur d’impression à partir duquel le package de pilotes est supprimé. Une valeur de pointeur NULL signifie l’ordinateur local.
-
pszInfPath [in]
-
Pointeur vers une chaîne constante terminée par null qui spécifie le chemin d’accès au fichier *.inf du pilote.
-
pszEnvironment [in]
-
Pointeur vers une chaîne constante terminée par null qui spécifie l’architecture du processeur (par exemple, Windows NT x86). Il peut s’agir de NULL.
Valeur retournée
S_OK, si l’opération réussit.
E_ACCESSDENIED, si le package a été fourni avec Windows.
HRESULT_CODE(ERROR_PRINT_DRIVER_PACKAGE_IN_USE), si le package est utilisé.
Sinon, hresult contient un code d’erreur.
Pour plus d’informations sur les codes d’erreur COM, consultez Gestion des erreurs.
Notes
Notes
Il s’agit d’une fonction bloquante ou synchrone qui peut ne pas être retournée immédiatement. La rapidité avec laquelle cette fonction retourne dépend de facteurs d’exécution tels que l’status réseau, la configuration du serveur d’impression et les facteurs d’implémentation du pilote d’imprimante qui sont difficiles à prédire lors de l’écriture d’une application. L’appel de cette fonction à partir d’un thread qui gère l’interaction avec l’interface utilisateur peut donner l’impression que l’application ne répond pas.
Le magasin de pilotes est généralement %windir%\inf ou %windir%\System32\DriverStore\FileRepository.
Un package de pilote fourni avec Windows ne peut pas être supprimé avec cette fonction.
L’utilisateur doit disposer de privilèges d’administration d’imprimante.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 2008 [applications de bureau uniquement] |
| En-tête |
|
| Bibliothèque |
|
| DLL |
|
| Noms Unicode et ANSI |
DeletePrinterDriverPackageW (Unicode) et DeletePrinterDriverPackageA (ANSI) |