Função MgmGetMfe (mgm.h)

  • Artigo

A função MgmGetMfe recupera um MFE específico.

Sintaxe

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

Parâmetros

[in] pimm

Ponteiro para uma estrutura MIB_IPMCAST_MFE que especifica o MFE a ser recuperado. 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 que o buffer apontado por pbBuffer deverá ser para manter o 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 MFE especificado. O MFE é uma estrutura MIB_IPMCAST_MFE .

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 conter o MFE. O cliente deve marcar o valor de pdwBufferSize para o tamanho mínimo do buffer necessário para recuperar o MFE.
ERROR_NOT_FOUND
 O MFE especificado não foi encontrado.

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

MgmGetFirstMfe

MgmGetNextMfe