DeletePrinterDataEx fonction)
La fonction DeletePrinterDataEx supprime une valeur spécifiée des données de configuration pour une imprimante. Les données de configuration d’une imprimante consistent en un ensemble de valeurs nommées et typées stockées dans une hiérarchie de clés de registre. La fonction supprime une valeur spécifiée sous une clé spécifiée.
À l’instar de la fonction DeletePrinterData , DeletePrinterDataEx peut supprimer des valeurs stockées par la fonction SetPrinterData . En outre, DeletePrinterDataEx peut supprimer des valeurs stockées sous une clé spécifiée par la fonction SetPrinterDataEx .
Syntaxe
DWORD DeletePrinterDataEx(
_In_ HANDLE hPrinter,
_In_ LPCTSTR pKeyName,
_In_ LPCTSTR pValueName
);
Paramètres
-
hPrinter [ dans]
-
Handle vers l’imprimante pour laquelle la fonction supprime une valeur. Utilisez la fonction OpenPrinter ou AddPrinter pour récupérer un handle d’imprimante.
-
pKeyName [ dans]
-
Pointeur vers une chaîne se terminant par un caractère null qui spécifie la clé contenant la valeur à supprimer. Utilisez la barre oblique inverse ( \ ) comme séparateur pour spécifier un chemin d’accès qui a une ou plusieurs sous-clés.
Si pKeyName a la valeur null ou est une chaîne vide, DELETEPRINTERDATAEX retourne un paramètre d’erreur _ non valide _ .
-
pValueName [ dans]
-
Pointeur vers une chaîne se terminant par un caractère null qui spécifie le nom de la valeur à supprimer.
Valeur de retour
Si la fonction réussit, la valeur de retour est une erreur de _ réussite.
Si la fonction échoue, la valeur de retour est un code d’erreur système.
Remarques
Notes
Il s’agit d’une fonction de blocage ou synchrone qui peut ne pas être renvoyée immédiatement. La vitesse à laquelle cette fonction est retournée dépend des facteurs d’exécution tels que l’état du réseau, la configuration du serveur d’impression et les facteurs d’implémentation des pilotes 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 faire que l’application semble ne pas répondre.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 2000 Professionnel - [Applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows 2000 Server - [Applications de bureau uniquement] |
| En-tête |
|
| Bibliothèque |
|
| DLL |
|
| Noms Unicode et ANSI |
DeletePrinterDataExW (Unicode) et DeletePrinterDataExA (ANSI) |