RasAdminPortEnum 函数

[此函数仅用于向后兼容 Windows NT Server 4.0。它在 Windows Server 2003 上返回ERROR_CALL_NOT_IMPLEMENTED。应用程序应使用 MprAdminPortEnum 函数。]

RasAdminPortEnum 函数枚举指定 RAS 服务器上的所有端口。对于服务器上的每个端口，函数返回包含有关端口信息的 RAS_PORT_0 结构。

语法

DWORD RasAdminPortEnum(
  _In_  const WCHAR       *lpszServer,
  _Out_       PRAS_PORT_0 *ppRasPort0,
  _Out_       WORD        *pcEntriesRead
);

lpszServer [in]: 指向以 null 结尾的 Unicode 字符串的指针，该字符串指定 RAS 服务器的名称。指定具有前导“\\”字符的名称，格式为：\\servername。
ppRasPort0 [out]: 指向变量的指针，该变量接收指向包含 RAS_PORT_0 结构的数组的缓冲区的指针。应用程序完成内存后，通过调用 RasAdminFreeBuffer 函数来释放内存。
pcEntriesRead [out]: 指向 16 位变量的指针，该变量接收 ppRasPort0 数组中返回的RAS_PORT_0结构总数。

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

如果函数失败，则返回值可能是以下错误代码。

值	含义
NERR_ItemNotFound	无法枚举任何端口。这可能是因为服务器上所有配置的端口当前都用于拨出。

此函数没有扩展的错误信息;不要调用 GetLastError。