ConfigurePort 函式

ConfigurePort函式會顯示指定伺服器上端口的埠組態對話方塊。

語法

BOOL ConfigurePort(
  _In_ LPTSTR pName,
  _In_ HWND   hWnd,
  _In_ LPTSTR pPortName
);

參數

pName [in]

Null 終止字串的指標，指定指定指定埠所在的伺服器名稱。 如果此參數為 Null，則埠為本機。

hWnd [in]

埠組態對話方塊的父視窗控制碼。

pPortName [in]

指定要設定之埠名稱的 Null 終止字串指標。

傳回值

如果函式成功，則傳回值是非零值。

如果此函式失敗，則傳回值為零。

備註

注意

這是封鎖或同步函式，可能不會立即傳回。 此函式傳回的速度取決於執行時間因素，例如網路狀態、列印伺服器組態，以及難以在撰寫應用程式時預測的印表機驅動程式實作因素。 從管理與使用者介面互動的執行緒呼叫此函式，可能會讓應用程式看起來沒有回應。

呼叫 ConfigurePort 函式之前，應用程式應該呼叫 EnumPorts 函式來判斷有效的埠名稱。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	Winspool.h (包含 Windows.h)
程式庫	Winspool.lib
DLL	Winspool.drv
Unicode 與 ANSI 名稱	ConfigurePortW (Unicode) 和 ConfigurePortA (ANSI)

另請參閱

列印

列印多工緩衝處理器 API 函式

EnumPorts