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
Referenz