IPrintDialogServices::GetCurrentPortName

[Dies ist vorläufige Dokumentation und Änderungenvorbehalten.]

Die GetCurrentPortName -Methode, um den Namen des aktuellen Hafens abrufen kann eine Anwendung mithilfe der PrintDlgEx -Funktion aufrufen.

HRESULT GetCurrentPortName ()   LPTSTRLpPortName,UINT* PcchSize);
 

Parameter

lpPortName

Zeiger auf einen Puffer, der den Null-terminierte Namen des aktuellen Hafens empfängt.

pcchSize

Zeiger auf eine Variable UINT . Bei der Eingabe gibt der Variablen die Größe in Bytes (ANSI-Version) oder 16-Bit-Zeichen (Unicode-Version), des Puffers, auf den der LpPortName -Parameter. Bei der Ausgabe enthält die Variable die Anzahl von Bytes oder Zeichen, einschließlich des abschließenden Null-Zeichens, in den Puffer geschriebenen.

Wenn die Größe Null bei der Eingabe ist, die Funktion gibt zurück die erforderliche Puffergröße (in Bytes oder Zeichen) in PcchSize und den LpPortName -Puffer wird nicht verwendet.

Rückgabewerte

Wenn die Methode erfolgreich ist, ist der Rückgabewert S_OK. Wenn es keine aktuellen Port gibt, wird S_OK zurückgegeben, der in PcchSize zurückgegebene Wert ist NULL, und der LpPortName -Puffer ist unverändert.

Wenn ein Fehler auftritt, ist der Rückgabewert einen COM-Fehler-Code. Weitere Informationen finden Sie unter Error Handling.

QuickInfo

&Nbsp; Windows NT: Version 5.0 oder höher erforderlich.
Windows:Nicht unterstützt.
Windows CE:Nicht unterstützt.
Header:In commdlg.h deklariert.

Siehe auch

Übersicht über common Dialog Box Library, IPrintDialogServices, PrintDlgEx

Index