Share via


IPrintDialogServices::GetCurrentPortName 方法 (commdlg.h)

擷取目前埠的名稱,以與 PrintDlgEx 搭配使用。

語法

HRESULT GetCurrentPortName(
  LPWSTR pPortName,
  UINT   *pcchSize
);

參數

pPortName

類型: LPTSTR

目前埠的名稱。

pcchSize

類型: UINT*

在輸入時,變數會指定 lpPortName 參數所指向緩衝區的大小,以字元為單位。 在輸出時,變數會包含 ANSI) (位元組數,或 unicode) (的位元元組數目,包括寫入緩衝區的終止 Null 字元。

如果輸入的大小為零,則函式會傳回所需的緩衝區大小, (pcchSize 中的位元組或字元) ,而且不會使用 lpPortName 緩衝區。

傳回值

類型: HRESULT

如果方法成功,傳回值會 S_OK。 如果沒有目前的埠,傳回值S_OK,pcchSize 中傳回的值是零,lpPortName 緩衝區則保持不變。

如果發生錯誤,傳回值為 COM 錯誤碼。 如需詳細資訊,請參閱錯誤處理

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 commdlg.h (包含 Windows.h)
Dll Comdlg32.dll

另請參閱

通用對話框連結庫

概念

IPrintDialogServices

PrintDlgEx

參考