RasAdminPortGetInfo 函数
[此函数仅用于向后兼容 Windows NT Server 4.0。 它在 Windows Server 2003 上返回ERROR_CALL_NOT_IMPLEMENTED。 应用程序应使用 MprAdminPortGetInfo 函数。]
RasAdminPortGetInfo 函数检索有关指定服务器上的指定端口的信息。
语法
DWORD RasAdminPortGetInfo(
_In_ const WCHAR *lpszServer,
_In_ const WCHAR *lpszPort,
_Out_ RAS_PORT_1 *pRasPort1,
_Out_ RAS_PORT_STATISTICS *pRasStats,
_Out_ RAS_PARAMETERS **ppRasParams
);
parameters
-
lpszServer [in]
-
指向以 null 结尾的 Unicode 字符串的指针，该字符串指定 RAS 服务器的名称。 指定具有前导“\\”字符的名称，格式为：\\servername。
-
lpszPort [in]
-
指向以 null 结尾的 Unicode 字符串的指针，该字符串指定服务器上的端口名称。
-
pRasPort1 [out]
-
指向 RAS_PORT_1 结构的指针，该结构由函数填充有关端口状态的信息。
-
pRasStats [out]
-
指向函数用有关端口的统计信息填充的 RAS_PORT_STATISTICS 结构的指针。
-
ppRasParams [out]
-
指向一个指针变量的指针，该变量接收 RAS_PARAMETERS 结构数组的地址。 每个结构都包含特定于媒体的密钥（如 MAXCONNECTBPS）的名称及其关联值。 当应用程序完成此内存后，通过调用 RasAdminFreeBuffer 函数来释放它。
返回值
如果函数成功，则返回值为 ERROR_SUCCESS。
如果函数失败，则返回值可能是以下错误代码之一。
| 值 | 含义 |
|---|---|
|
指定的端口无效。 |
|
内存不足，无法为 ppRasParams 数组分配缓冲区。 |
此函数没有扩展的错误信息;不要调用 GetLastError。
要求
| 要求 | 值 |
|---|---|
| 客户端支持终止 |
Windows 2000 Professional |
| 终止服务器支持 |
Windows 2000 Server |
| 标头 |
|
| 库 |
|
| DLL |
|