IPrintDialogServices::GetCurrentPrinterName-Methode (commdlg.h)

Ruft den Namen des derzeit ausgewählten Druckers zur Verwendung mit PrintDlgEx ab.

Syntax

HRESULT GetCurrentPrinterName(
  LPWSTR pPrinterName,
  UINT   *pcchSize
);

Parameter

pPrinterName

Typ: LPTSTR

Der Name des derzeit ausgewählten Druckers.

pcchSize

Typ: UINT*

Bei der Eingabe gibt die Variable die Größe des Puffers in Zeichen an, auf den der lpPrinterName-Parameter verweist. Bei der Ausgabe enthält die Variable die Anzahl der Bytes (ANSI) oder Zeichen (Unicode), einschließlich des abschließenden NULL-Zeichens, das in den Puffer geschrieben wird.

Wenn die Größe bei der Eingabe null ist, gibt die Funktion die erforderliche Puffergröße (in Bytes oder Zeichen) in pcchSize zurück und verwendet nicht den Puffer lpPrinterName .

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 pcchSize zurückgegebene Wert null, und der Puffer lpPrinterName bleibt 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 (windows.h einschließen)
DLL	Comdlg32.dll

Weitere Informationen

Allgemeine Dialogfeldbibliothek

Konzept

IPrintDialogServices

PrintDlgEx

Referenz