mgmGetMfeStats 函数 (mgm.h)

  • 项目

MgmGetMfeStats 函数检索特定 MFE 的统计信息。 返回的统计信息包括收到的数据包、接收的字节数以及每个传出接口上转发的数据包。

语法

DWORD MgmGetMfeStats(
  [in]      PMIB_IPMCAST_MFE pimm,
  [in, out] PDWORD           pdwBufferSize,
  [in, out] PBYTE            pbBuffer,
            DWORD            dwFlags
);

parameters

[in] pimm

指向 MIB_IPMCAST_MFE 结构的指针，该结构指定要检索其统计信息的 MFE。 要返回的信息由MIB_IPMCAST_MFE结构的 dwSource 和 dwGroup 成员指示。

[in, out] pdwBufferSize

在输入时， pdwBufferSize 是指向 DWORD 大小的内存位置的指针，该位置包含 pbBuffer 指向的缓冲区的大小（以字节为单位）。

在输出时，如果返回值为ERROR_INSUFFICIENT_BUFFER， 则 pdwBufferSize 接收 pbBuffer 指向的缓冲区的最小大小，以保存 MFE 统计信息集;否则， pdwBufferSize 的值保持不变。

[in, out] pbBuffer

在输入时，客户端必须提供指向缓冲区的指针。

在输出时， pbBuffer 包含指定的 MFE 统计信息集。

dwFlags

确定返回的数据结构。

值 含义
MGM_MFE_STATS_0
 包括与 MIB_IPMCAST_MFE_STATS对应的统计信息。
MGM_MFE_STATS_1
 包括与 MIB_IPMCAST_MFE_STATS_EX对应的统计信息。

返回值

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

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

值 含义
ERROR_CAN_NOT_COMPLETE
 无法完成对此函数的调用。
ERROR_INSUFFICIENT_BUFFER
 指定的缓冲区太小，即使是一个 MFE 的统计信息也是如此。 客户端应为检索一个 MFE 的统计信息所需的最小缓冲区大小检查 pdwBufferSize 的值。
ERROR_NOT_FOUND
 找不到指定的 MFE。

注解

MFE 统计信息以 dwFlags 参数确定的MIB_IPMCAST_MFE_STATS或MIB_IPMCAST_MFE_STATS_EX结构返回。

要求

   
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 mgm.h
Library Rtm.lib
DLL Rtm.dll

另请参阅

MIB_IPMCAST_MFE_STATS

MIB_IPMCAST_MFE_STATS_EX

MgmGetFirstMfeStats

MgmGetNextMfeStats