Compartilhar via

Função MgmGetMfeStats (mgm.h)

  • Artigo

A função MgmGetMfeStats recupera as estatísticas de um MFE específico. As estatísticas retornadas incluem os pacotes recebidos, os bytes recebidos e os pacotes encaminhados em cada interface de saída.

Sintaxe

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

Parâmetros

[in] pimm

Ponteiro para uma estrutura MIB_IPMCAST_MFE que especifica o MFE para o qual recuperar estatísticas. As informações a serem retornadas são indicadas pelos membros dwSource e dwGroup da estrutura MIB_IPMCAST_MFE .

[in, out] pdwBufferSize

Na entrada, pdwBufferSize é um ponteiro para um local de memória do tamanho DWORD que contém o tamanho, em bytes, do buffer apontado por pbBuffer.

Na saída, se o valor retornado for ERROR_INSUFFICIENT_BUFFER, pdwBufferSize receberá o tamanho mínimo para o qual o buffer apontado por pbBuffer deverá conter o conjunto de estatísticas MFE; caso contrário, o valor de pdwBufferSize permanece inalterado.

[in, out] pbBuffer

Na entrada, o cliente deve fornecer um ponteiro para um buffer.

Na saída, pbBuffer contém o conjunto especificado de estatísticas de MFE.

dwFlags

Determina a estrutura de dados retornada.

Valor Significado
MGM_MFE_STATS_0
 Inclua estatísticas correspondentes a MIB_IPMCAST_MFE_STATS.
MGM_MFE_STATS_1
 Inclua estatísticas correspondentes a MIB_IPMCAST_MFE_STATS_EX.

Valor retornado

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos códigos de erro a seguir.

Valor Significado
ERROR_CAN_NOT_COMPLETE
 Não foi possível concluir a chamada para essa função.
ERROR_INSUFFICIENT_BUFFER
 O buffer especificado é muito pequeno para as estatísticas de até mesmo um MFE. O cliente deve marcar o valor de pdwBufferSize para o tamanho mínimo do buffer necessário para recuperar estatísticas para um MFE.
ERROR_NOT_FOUND
 O MFE especificado não foi encontrado.

Comentários

As estatísticas de MFE são retornadas em uma estrutura MIB_IPMCAST_MFE_STATS ou MIB_IPMCAST_MFE_STATS_EX determinada pelo parâmetro dwFlags .

Requisitos

   
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mgm.h
Biblioteca Rtm.lib
DLL Rtm.dll

Confira também

MIB_IPMCAST_MFE_STATS

MIB_IPMCAST_MFE_STATS_EX

MgmGetFirstMfeStats

MgmGetNextMfeStats