IPrintDialogServices::GetCurrentDevMode-Methode (commdlg.h)

Artikel
08/22/2023

Füllt eine DEVMODE-Struktur mit Informationen zum aktuell ausgewählten Drucker für die Verwendung mit PrintDlgEx.

Syntax

HRESULT GetCurrentDevMode(
  LPDEVMODE pDevMode,
  UINT      *pcbSize
);

Parameter

pDevMode

Typ: LPDEVMODE

Ein Zeiger auf einen Puffer, der eine DEVMODE-Struktur empfängt, die Informationen zum aktuell ausgewählten Drucker enthält.

pcbSize

Typ: UINT*

Bei der Eingabe gibt die Variable die Größe des Puffers in Bytes an, auf den der lpDevMode-Parameter verweist. Bei der Ausgabe enthält die Variable die Anzahl der Bytes, die in lpDevMode geschrieben wurden.

Wenn die Größe bei der Eingabe 0 ist, gibt die Funktion die erforderliche Puffergröße (in Bytes) in pcbSize zurück und verwendet nicht den puffer lpDevMode .

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Wenn derzeit kein Drucker ausgewählt ist, wird der Rückgabewert S_OK, der in pcbSize zurückgegebene Wert ist 0, und der puffer lpDevMode ist unverändert.

Wenn ein Fehler auftritt, ist der Rückgabewert ein COM-Fehlercode. Weitere Informationen finden Sie unter Fehlerbehandlung.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	commdlg.h (einschließlich Windows.h)
DLL	Comdlg32.dll