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 |
另請參閱
概念
參考