Fonction SetDefaultPrinter
La fonction SetDefaultPrinter définit le nom de l’imprimante par défaut pour l’utilisateur actuel sur l’ordinateur local.
Syntaxe
BOOL SetDefaultPrinter(
_In_ LPCTSTR pszPrinter
);
Paramètres
-
pszPrinter [in]
-
Pointeur vers une chaîne terminée par null contenant le nom d’imprimante par défaut. Pour une connexion d’imprimante distante, le format de nom est **\nom_imprimante_serveur\**. Pour une imprimante locale, le format de nom est printername.
Si ce paramètre a la valeur NULL ou une chaîne vide, c’est-à-dire « », SetDefaultPrinter sélectionne une imprimante par défaut à partir de l’une des imprimantes installées. Si une imprimante par défaut existe déjà, l’appel de SetDefaultPrinter avec une valeur NULL ou une chaîne vide dans ce paramètre peut modifier l’imprimante par défaut.
Valeur retournée
Si la fonction réussit, la valeur de retour est une valeur différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro.
Notes
Lorsque vous utilisez cette méthode, vous devez spécifier une imprimante, un pilote et un port valides. Si elles ne sont pas valides, les API n’échouent pas, mais le résultat n’est pas défini. Cela peut amener d’autres programmes à rebasser l’imprimante sur l’imprimante valide précédente. Vous pouvez utiliser EnumPrinters pour récupérer le nom de l’imprimante, le nom du pilote et le nom de port de toutes les imprimantes disponibles.
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.
Spécifications
| 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 |
SetDefaultPrinterW (Unicode) et SetDefaultPrinterA (ANSI) |