mgmGetMfe 函式 (mgm.h)

MgmGetMfe 函式會擷取特定的 MFE。

語法

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

[in] pimm

指定要擷取之 MFE 之MIB_IPMCAST_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。