mgmGetMfe 函数 (mgm.h)

MgmGetMfe 函数检索特定的 MFE。

语法

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

[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。 MFE 是一种 MIB_IPMCAST_MFE 结构。

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

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

值	含义
ERROR_CAN_NOT_COMPLETE	无法完成对此函数的调用。
ERROR_INSUFFICIENT_BUFFER	指定的缓冲区太小，无法容纳 MFE。客户端应检查 pdwBufferSize 的值，以获取检索 MFE 所需的最小缓冲区大小。
ERROR_NOT_FOUND	找不到指定的 MFE。