AddPort 函式
AddPort函式會將埠的名稱新增至支援的埠清單。 AddPort函式是由埠監視器匯出。
語法
BOOL AddPort(
_In_ LPTSTR pName,
_In_ HWND hWnd,
_In_ LPTSTR pMonitorName
);
參數
-
pName [in]
-
以零結尾字串的指標，指定埠所連接之伺服器的名稱。 如果此參數為 Null，則埠為本機。
-
hWnd [in]
-
AddPort對話方塊之父視窗的控制碼。
-
pMonitorName [in]
-
指定與埠相關聯之監視器之零終止字串的指標。
傳回值
如果函式成功，則傳回值是非零值。
如果此函式失敗，則傳回值為零。
備註
注意
這是封鎖或同步函式，可能不會立即傳回。 此函式傳回的速度取決於執行時間因素，例如網路狀態、列印伺服器設定，以及撰寫應用程式時難以預測的印表機驅動程式實作因素。 從管理與使用者介面互動的執行緒呼叫此函式，可能會使應用程式看起來沒有回應。
AddPort函式會流覽網路以尋找現有的埠，並顯示使用者的對話方塊。 AddPort函式應該藉由呼叫EnumPorts來驗證使用者輸入的埠名稱，以確保沒有任何重複的名稱存在。
AddPort函式的呼叫端必須具有埠所連線之伺服器的SERVER_ACCESS_ADMINISTER存取權。
若要新增埠而不顯示對話方塊，請呼叫 XcvData 函式，而不是 AddPort。 如需 XcvData的詳細資訊，請參閱 Microsoft Windows 驅動程式開發工具組 (DDK) 。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限桌面應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|
| Unicode 與 ANSI 名稱 |
AddPortW (Unicode) 和 AddPortA (ANSI) |