AdvancedDocumentProperties-Funktion
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 |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
AdvancedDocumentPropertiesW (Unicode) und AdvancedDocumentPropertiesA (ANSI) |