[New - Windows NT]
RasAdminPortGetInfo功能检索指定服务器上指定端口的信息【.】
DWORD RasAdminPortGetInfo
const WCHAR *【lpszServer】, | //指向服务器名称的指针 |
const WCHAR *【lpszPort】, | //指向服务器上端口名称的指针 |
RAS_PORT_1 *【pRasPort1】, | //接收端口的状态 |
RAS_PORT_STATISTICS *【pRasStats】, | //接收有关端口的统计信息 |
RAS_PARAMETERS **【ppRasParams】 | //接收一组媒体特定的参数和值 |
); |
参数
【lpszServer】
指向包含Windows NT RAS服务器名称的以null终止的Unicode字符串。使用前导“\\\\”字符指定名称,格式为:\\\\ 【服务器名称】.
【lpszPort】
指向包含服务器端口名称的以null结尾的Unicode字符串。
【pRasPort1】
指向RAS_PORT_1结构的指针,该函数填充有关端口状态的信息。
【pRasStats】
指向RAS_PORT_STATISTICS结构的指针,该函数使用该端口的统计信息填充。
【ppRasParams】
指向接收到RAS_PARAMETERS结构数组的指针的变量的指针。每个结构都包含媒体专用密钥的名称,例如MAXCONNECTBPS及其关联值。当您的应用程序完成* 【ppRasParams】指向的内存后,通过调用RasAdminFreeBuffer函数将其释放。
返回值
如果函数成功,则返回值为ERROR_SUCCESS。
如果函数失败,则返回值可以是以下错误代码之一。
值 | 含义 |
ERROR_DEV_NOT_EXIST | 指定的端口无效。 |
ERROR_NOT_ENOUGH_MEMORY | 内存不足为【ppRasParams】阵列分配缓冲区。 |
不要致电GetLastError以获取此函数的错误信息。
也可以看看
RAS_PARAMETERS, RAS_PORT_1, RAS_PORT_STATISTICS, RasAdminFreeBuffer