AdvancedDocumentProperties-Funktion

Artikel
06/12/2023

Die AdvancedDocumentProperties-Funktion zeigt ein Dialogfeld "Druckerkonfiguration" für den angegebenen Drucker an, sodass der Benutzer diesen Drucker konfigurieren kann.

Diese Funktion ist ein Sonderfall der DocumentProperties-Funktion . Weitere Informationen finden Sie im Abschnitt Hinweise.

Syntax

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

Parameter

hWnd [in]: Ein Handle zum übergeordneten Fenster des Dialogfelds Druckerkonfiguration.
hPrinter [in]: Ein Handle für ein Druckerobjekt. Verwenden Sie die OpenPrinter - oder AddPrinter-Funktion , um einen Druckerhandle abzurufen.
pDeviceName [in]: Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen des Geräts angibt, für das ein Druckerkonfigurationsdialogfeld angezeigt werden soll.
pDevModeOutput [out]: Ein Zeiger auf eine DEVMODE-Struktur , die die vom Benutzer angegebenen Konfigurationsdaten enthält.
pDevModeInput [in]: Ein Zeiger auf eine DEVMODE-Struktur , die die Konfigurationsdaten enthält, die zum Initialisieren der Steuerelemente des Dialogfelds Druckerkonfiguration verwendet werden.

Rückgabewert

Wenn die DocumentProperties-Funktion mit diesen Parametern erfolgreich ist, ist der Rückgabewert von AdvancedDocumentProperties 1. Andernfalls ist der Rückgabewert 0.

Bemerkungen

Hinweis

Dies ist eine blockierende oder synchrone Funktion und wird möglicherweise nicht sofort zurückgegeben. Wie schnell diese Funktion zurückgibt, hängt von Laufzeitfaktoren wie Netzwerk-status, Druckserverkonfiguration und Druckertreiberimplementierungsfaktoren ab, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Wenn Sie diese Funktion über einen Thread aufrufen, der die Interaktion mit der Benutzeroberfläche verwaltet, kann die Anwendung nicht reagieren.

Diese Funktion kann nur das Dialogfeld Druckerkonfiguration anzeigen, sodass ein Benutzer es konfigurieren kann. Verwenden Sie DocumentProperties, um mehr Kontrolle zu bekommen. Die Eingabeparameter für diese Funktion werden direkt an DocumentProperties übergeben, und der fMode-Wert wird auf DM_IN_BUFFER | DM_IN_PROMPT | DM_OUT_BUFFER. Im Gegensatz zu DocumentProperties gibt diese Funktion nur 1 oder 0 zurück. Daher können Sie die erforderliche Größe von DEVMODE nicht ermitteln, indem Sie pDevMode auf 0 festlegen.

Eine Anwendung kann den Namen abrufen, auf den der pDeviceName-Parameter verweist, indem sie die GetPrinter-Funktion aufruft und dann das pPrinterName-Element der PRINTER_INFO_2-Struktur untersucht.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Winspool.h (einschließlich Windows.h)
Bibliothek	Winspool.lib
DLL	Winspool.drv
Unicode- und ANSI-Name	AdvancedDocumentPropertiesW (Unicode) und AdvancedDocumentPropertiesA (ANSI)

Siehe auch

Drucken
Druckspooler-API-Funktionen
AddPrinter
DEVMODE
Documentproperties
GetPrinter
OpenPrinter
PRINTER_INFO_2

Share via