描述
AddPort功能将端口的名称添加到支持的端口列表中。AddPort功能由端口监视器导出。
C++ 语法
BOOL AddPort( __in LPTSTR pName, __in HWND hWnd, __in LPTSTR pMonitorName ); |
PowerBASIC 语法
FUNCTION AddPortA ( _ BYREF pName AS ASCIIZ, _ BYVAL hWnd AS DWORD, _ BYREF pMonitorName AS ASCIIZ _ ) AS LONG |
Unicode版本:
FUNCTION AddPortW ( _ BYREF pName AS WSTRINGZ, _ BYVAL hWnd AS DWORD, _ BYREF pMonitorName AS WSTRINGZ _ ) AS LONG |
参数
pName
[in]指向一个零终止字符串的指针，指定端口连接到的服务器的名称。如果此参数为NULL，端口为本地端口。
hWnd
[in]处理到AddPort对话框的父窗口。
pMonitorName
[in]指向指定与端口关联的监视器的零终止字符串的指针。
返回值
如果函数成功，则返回值为非零值。
如果函数失败，返回值为零。
备注
AddPort功能浏览网络查找现有端口，并显示用户对话框。AddPort功能应通过调用EnumPorts验证用户输入的端口名称，以确保不存在重复的名称。
AddPort函数的调用者必须对端口连接的服务器具有SERVER_ACCESS_ADMINISTER访问权限。
要添加端口而不显示对话框，请调用XcvData功能，而不是AddPort.有关XcvData的详细信息，请参阅Microsoft Windows 2000驱动程序开发工具包。
Windows 95/98 / Me：Microsoft Layer for Unicode支持AddPortW.
引用文件 #INCLUDE Once
WinSpool.inc（包括Windows.inc）