Função MgmGetNextMfeStats (mgm.h)

  • Artigo

A função MgmGetNextMfeStats recupera um ou mais conjuntos de estatísticas MFE. O gerenciador de tabela de roteamento começa a recuperar estatísticas começando com o MFE que segue o MFE especificado. A função pode recuperar zero, um ou mais conjuntos de estatísticas MFE. O número de conjuntos retornados depende do tamanho das entradas e do tamanho do buffer fornecido pelo cliente quando a função é chamada.

Os dados retornados no buffer são ordenados primeiro por grupo e, em seguida, pelas fontes dentro de um grupo. As estatísticas retornadas incluem os pacotes recebidos, os bytes recebidos e os pacotes encaminhados em cada interface de saída.

Sintaxe

DWORD MgmGetNextMfeStats(
  [in]      PMIB_IPMCAST_MFE pimmStart,
  [in, out] PDWORD           pdwBufferSize,
  [in, out] PBYTE            pbBuffer,
  [in, out] PDWORD           pdwNumEntries,
            DWORD            dwFlags
);

Parâmetros

[in] pimmStart

Ponteiro para uma estrutura de MIB_IPMCAST_MFE que especifica de onde começar a recuperar estatísticas de MFE. Os membros dwSource e dwGroup da estrutura MIB_IPMCAST_MFE identificam um MFE. Especifique a origem e o grupo do último MFE que foi retornado pela chamada anterior para MgmGetFirstMfeStats ou MgmGetNextMfeStats.

[in, out] pdwBufferSize

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

Na saída, se o valor retornado for ERROR_INSUFFICIENT_BUFFER, pdwBufferSize receberá o tamanho mínimo que pbBuffer deve conter um 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 um ou mais conjuntos de estatísticas de MFE. Cada conjunto de estatísticas de MFE é uma estrutura MIB_IPMCAST_MFE_STATS .

[in, out] pdwNumEntries

Na entrada, o cliente deve fornecer um ponteiro para um local de memória do tamanho DWORD.

Na saída, pdwNumEntries recebe o número de conjuntos de estatísticas MFE contidos no pbBuffer.

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.

Retornar valor

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 até mesmo um conjunto de estatísticas MFE. O cliente deve marcar o valor de pdwBufferSize para o tamanho mínimo do buffer necessário para recuperar um conjunto de estatísticas.
ERROR_MORE_DATA
 Mais estatísticas de MFE estão disponíveis.
ERROR_NO_MORE_ITEMS
 Não há mais estatísticas de MFE disponíveis. Zero ou mais conjuntos de estatísticas MFE foram retornados; marcar o valor de pdwNumEntries para verificar quantos conjuntos de estatísticas foram retornados.

Comentários

Essa função é usada para continuar a recuperação sequencial de estatísticas de MFE; use MgmGetFirstMfeStats para iniciar o processo de recuperação.

Em geral, para recuperar estatísticas de MFE, primeiro chame MgmGetFirstMfeStats. Em seguida, chame MgmGetNextMfeStats uma ou mais vezes, até que não haja mais MFEs para retornar. Cada chamada para MgmGetNextMfeStats deve começar após o último MFE retornado pela chamada anterior para MgmGetNextMfeStats (ou a chamada inicial para MgmGetFirstMfeStats) Para fazer isso, o cliente especifica a última origem e o grupo no buffer retornados por uma chamada anterior.

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 .

Nota O tamanho mínimo do buffer apontado por pbBuffer não é fixo; é diferente para cada conjunto de estatísticas de MFE. Use a macro sizeof para determinar o tamanho de cada conjunto de estatísticas retornado no buffer.
 

Requisitos

Requisito Valor
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

MgmGetMfeStats