Fonction AdvancedDocumentProperties

La fonction AdvancedDocumentProperties affiche une boîte de dialogue de configuration d’imprimante pour l’imprimante spécifiée, ce qui permet à l’utilisateur de configurer cette imprimante.

Cette fonction est un cas spécial de la fonction DocumentProperties . Pour plus d’informations, consultez la section Remarques.

Syntaxe

LONG AdvancedDocumentProperties(
  _In_  HWND     hWnd,
  _In_  HANDLE   hPrinter,
  _In_  LPTSTR   pDeviceName,
  _Out_ PDEVMODE pDevModeOutput,
  _In_  PDEVMODE pDevModeInput
);

Paramètres

hWnd [in]

Handle de la fenêtre parente de la boîte de dialogue configuration de l’imprimante.

hPrinter [in]

Handle pour un objet d’imprimante. Utilisez la fonction OpenPrinter ou AddPrinter pour récupérer un handle d’imprimante.

pDeviceName [in]

Pointeur vers une chaîne terminée par null spécifiant le nom de l’appareil pour lequel une boîte de dialogue de configuration d’imprimante doit être affichée.

pDevModeOutput [out]

Pointeur vers une structure DEVMODE qui contiendra les données de configuration spécifiées par l’utilisateur.

pDevModeInput [in]

Pointeur vers une structure DEVMODE qui contient les données de configuration utilisées pour initialiser les contrôles de la boîte de dialogue configuration de l’imprimante.

Valeur retournée

Si la fonction DocumentProperties avec ces paramètres réussit, la valeur de retour d’AdvancedDocumentProperties est 1. Sinon, la valeur de retour est égale à zéro.

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.

Cette fonction peut uniquement afficher la boîte de dialogue de configuration de l’imprimante afin qu’un utilisateur puisse la configurer. Pour plus de contrôle, utilisez DocumentProperties. Les paramètres d’entrée de cette fonction sont transmis directement à DocumentProperties et la valeur fMode est définie sur DM_IN_BUFFER | DM_IN_PROMPT | DM_OUT_BUFFER. Contrairement à DocumentProperties, cette fonction retourne uniquement 1 ou 0. Par conséquent, vous ne pouvez pas déterminer la taille requise de DEVMODE en définissant pDevMode sur zéro.

Une application peut obtenir le nom pointé par le paramètre pDeviceName en appelant la fonction GetPrinter , puis en examinant le membre pPrinterName de la structure PRINTER_INFO_2 .

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	Winspool.h (inclure Windows.h)
Bibliothèque	Winspool.lib
DLL	Winspool.drv
Noms Unicode et ANSI	AdvancedDocumentPropertiesW (Unicode) et AdvancedDocumentPropertiesA (ANSI)

Voir aussi

Impression

Fonctions API du spouleur d’impression

Addprinter

DEVMODE

DocumentProperties

GetPrinter

OpenPrinter

PRINTER_INFO_2