MprConfigServerGetInfo 函数 (mprapi.h)

MprConfigServerGetInfo 函数检索指定路由器的服务器级配置信息。

语法

DWORD MprConfigServerGetInfo(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwLevel,
  [out] LPBYTE *lplpbBuffer
);

[in] hMprConfig

路由器配置的句柄。通过调用 MprConfigServerConnect 获取此句柄。

[in] dwLevel

一个 DWORD 值，该值描述 在 lplpBuffer 参数中返回信息时采用的格式。 dwLevel 可接受的值包括下表中列出的 0、1 和 2。

值	结构格式
0	Windows 2000 Server 或更高版本： MPR_SERVER_0
1	Windows Server 2003 或更高版本： MPR_SERVER_1
2	Windows Server 2008 或更高版本： MPR_SERVER_2

[out] lplpbBuffer

成功完成后，指向 MPR_SERVER_0的指针 MPR_SERVER_1，
或 MPR_SERVER_2 结构。 dwLevel 参数指示结构的类型。使用 MprConfigBufferFree 释放此缓冲区的内存。

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

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

值	含义
ERROR_INVALID_PARAMETER	以下至少一个条件成立： hMprConfig 参数为 NULL。 dwLevel 参数不为零。 lplpBuffer 参数为 NULL。
ERROR_NOT_ENOUGH_MEMORY	资源不足，无法完成操作。
其他	使用 FormatMessage 检索与返回的错误代码对应的系统错误消息。