IPrintDialogServices::GetCurrentPortName-Methode (commdlg.h)

Ruft den Namen des aktuellen Ports zur Verwendung mit PrintDlgEx ab.

Syntax

HRESULT GetCurrentPortName(
  LPWSTR pPortName,
  UINT   *pcchSize
);

Parameter

pPortName

Typ: LPTSTR

Der Name des aktuellen Ports.

pcchSize

Typ: UINT*

Bei der Eingabe gibt die Variable die Größe des Puffers in Zeichen an, auf den der lpPortName-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 lpPortName .

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Wenn kein aktueller Port vorhanden ist, wird der Rückgabewert S_OK, der in pcchSize zurückgegebene Wert ist null, und der puffer lpPortName bleibt unverändert.

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

Anforderungen

Anforderung	Wert
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