NetServerTransportAdd 函数 (lmserver.h)
NetServerTransportAdd 函数将服务器绑定到传输协议。
扩展函数 NetServerTransportAddEx 允许调用应用程序指定 SERVER_TRANSPORT_INFO_1、 SERVER_TRANSPORT_INFO_2和 SERVER_TRANSPORT_INFO_3 信息级别。
语法
NET_API_STATUS NET_API_FUNCTION NetServerTransportAdd(
[in] LMSTR servername,
[in] DWORD level,
[in] LPBYTE bufptr
);
参数
[in] servername
指向字符串的指针，该字符串指定要在其中执行函数的远程服务器的名称。 如果此参数为 NULL，则使用本地计算机。
[in] level
指定数据的信息级别。 此参数可以是以下值。
| 值 | 含义 |
|---|---|
|
指定有关传输协议的信息，包括网络上的名称、地址和位置。 bufptr 参数指向SERVER_TRANSPORT_INFO_0结构。 |
[in] bufptr
指向包含数据的缓冲区的指针。
有关详细信息，请参阅 网络管理功能缓冲区。
返回值
如果函数成功，则返回值NERR_Success。
如果函数失败，则返回值可能是以下错误代码之一。
| 返回代码 | 说明 |
|---|---|
|
用户无权访问请求的信息。 |
|
网络上存在重复的名称。 |
|
在网络上找不到域名。 |
|
为 级别 参数指定的值无效。 |
|
参数无效。
如果 bufptr 参数指向的 SERVER_TRANSPORT_INFO_0 结构中的svti0_transportname或svti0_transportaddress成员为 NULL，则返回此错误。 如果 bufptr 参数指向的 SERVER_TRANSPORT_INFO_0 结构中的 svti0_transportaddresslength 成员为零或大于 Windef.h 头文件) 中定义的MAX_PATH (，也会返回此错误。 对于其他无效参数，也会返回此错误。 |
|
可用内存不足。 |
注解
只有管理员或服务器操作员本地组的成员才能成功执行 NetServerTransportAdd 函数。
如果使用对 NetServerTransportAdd 函数的调用将传输协议添加到服务器，则服务器重新启动或重启后，连接不会保留。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | lmserver.h (包括 Lm.h) |
| Library | Netapi32.lib |
| DLL | Netapi32.dll |