Função MgmGroupEnumerationGetNext (mgm.h)

Artigo
08/24/2023

A função MgmGroupEnumerationGetNext recupera o próximo conjunto de entradas de grupo. As informações retornadas por essa função são uma lista de grupos unidos e as fontes solicitadas, se houver.

Os grupos não são retornados em nenhuma ordem específica.

Sintaxe

DWORD MgmGroupEnumerationGetNext(
  [in]      HANDLE hEnum,
  [in, out] PDWORD pdwBufferSize,
  [in, out] PBYTE  pbBuffer,
  [in, out] PDWORD pdwNumEntries
);

Parâmetros

[in] hEnum

Manipule para a enumeração obtida de uma chamada anterior para MgmGroupEnumerationStart.

[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á conter uma entrada de grupo; 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 uma ou mais entradas de grupo. Cada entrada de grupo é uma estrutura SOURCE_GROUP_ENTRY .

[in, out] pdwNumEntries

Na entrada, o cliente deve fornecer um ponteiro para um valor DWORD .

Na saída, pdwNumEntries recebe o número de grupos no pbBuffer.

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 conter até mesmo um grupo. O cliente deve marcar o valor de pdwBufferSize para o tamanho mínimo do buffer necessário para recuperar um grupo.
ERROR_INVALID_PARAMETER	Identificador inválido para uma enumeração.
ERROR_MORE_DATA	Mais grupos estão disponíveis.
ERROR_NO_MORE_ITEMS	Não há mais grupos disponíveis. Zero ou mais grupos foram retornados; marcar o valor de pdwNumEntries para verificar quantos grupos foram retornados.
ERROR_NOT_ENOUGH_MEMORY	Não há memória suficiente para concluir esta operação.

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

MgmGroupEnumerationEnd

MgmGroupEnumerationStart

SOURCE_GROUP_ENTRY