通过

MprAdminPortGetInfo 函数 (mprapi.h)

  • 项目

MprAdminPortGetInfo 函数获取特定端口的信息。

语法

DWORD MprAdminPortGetInfo(
  [in]  RAS_SERVER_HANDLE hRasServer,
  [in]  DWORD             dwLevel,
  [in]  HANDLE            hPort,
  [out] LPBYTE            *lplpbBuffer
);

参数

[in] hRasServer

要收集端口信息的 RAS 服务器计算机的句柄。 通过调用 MprAdminServerConnect 获取此句柄。

[in] dwLevel

一个 DWORD 值，该值描述 在 lplpbBuffer 参数中返回信息的格式。 dwLevel 的可接受值包括 0 和 1，如下表所示。

值 结构格式
0 RAS_PORT_0
1 RAS_PORT_1

[in] hPort

要为其收集信息的端口的句柄。 通过调用 MprAdminPortEnum 获取此句柄。

[out] lplpbBuffer

成功完成后，指向描述端口的结构的指针。 这些结构的类型RAS_PORT_0或RAS_PORT_1，具体取决于 dwLevel 参数的值。 通过调用 MprAdminBufferFree 释放此内存。

返回值

如果函数成功，则返回值 NO_ERROR。

如果函数失败，则返回值为以下错误代码之一。

值 含义
ERROR_ACCESS_DENIED
 调用应用程序没有足够的权限。
ERROR_DDM_NOT_RUNNING
 Demand Dial Manager (DDM) 未运行，可能是因为动态接口管理器 (DIM) 配置为仅在 LAN 上运行。
ERROR_INVALID_PARAMETER
 以下参数中至少有一个为 NULL 或未指向有效内存： lplpBuffer、 lpdwEntriesRead 或 lpdwTotalEntries。
ERROR_INVALID_PORT_HANDLE
 hPort 参数无效。
ERROR_NOT_SUPPORTED
 dwLevel 参数不为零。
其他
 来自 MprError.h、RasError.h 或 WinError.h 的错误。
 
 

注解

如果安装了 RRAS 可再发行组件，则此函数在 Windows NT 4.0 上可用。 但是，RRAS 可再发行组件附带的 Mprapi.dll 版本将函数导出为 RasAdminPortGetInfo ，而不是 MprAdminPortGetInfo。 因此，使用 RRAS 可再发行组件时，请使用 LoadLibrary 和 GetProcAddress 访问此函数。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 mprapi.h
Library Mprapi.lib
DLL Mprapi.dll

另请参阅

MprAdminBufferFree

MprAdminPortEnum

MprAdminServerConnect

RAS 管理功能

远程访问服务管理参考