Funzione MgmGroupEnumerationGetNext (mgm.h)

Articolo
08/24/2023

La funzione MgmGroupEnumerationGetNext recupera il set successivo di voci di gruppo. Le informazioni restituite da questa funzione sono un elenco di gruppi aggiunti e le origini richieste, se presenti.

I gruppi non vengono restituiti in un ordine specifico.

Sintassi

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

Parametri

[in] hEnum

Gestire l'enumerazione ottenuta da una chiamata precedente a MgmGroupEnumerationStart.

[in, out] pdwBufferSize

In input pdwBufferSize è un puntatore a una posizione di memoria con dimensioni DWORD che contiene le dimensioni, in byte, del buffer a cui punta pbBuffer.

Nell'output, se il valore restituito è ERROR_INSUFFICIENT_BUFFER, pdwBufferSize riceve le dimensioni minime a cui il buffer puntato da pbBuffer deve contenere una voce di gruppo; in caso contrario, il valore di pdwBufferSize rimane invariato.

[in, out] pbBuffer

All'input, il client deve fornire un puntatore a un buffer.

Nell'output , pbBuffer contiene una o più voci di gruppo. Ogni voce di gruppo è una struttura SOURCE_GROUP_ENTRY .

[in, out] pdwNumEntries

All'input, il client deve fornire un puntatore a un valore DWORD .

Nell'output pdwNumEntries riceve il numero di gruppi in pbBuffer.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_CAN_NOT_COMPLETE	Impossibile completare la chiamata a questa funzione.
ERROR_INSUFFICIENT_BUFFER	Il buffer specificato è troppo piccolo per contenere anche un gruppo. Il client deve controllare il valore di pdwBufferSize per le dimensioni minime del buffer necessarie per recuperare un gruppo.
ERROR_INVALID_PARAMETER	Handle non valido per un'enumerazione.
ERROR_MORE_DATA	Sono disponibili altri gruppi.
ERROR_NO_MORE_ITEMS	Non sono disponibili altri gruppi. Sono stati restituiti zero o più gruppi; controllare il valore di pdwNumEntries per verificare il numero di gruppi restituiti.
ERROR_NOT_ENOUGH_MEMORY	Memoria insufficiente per completare questa operazione.

Requisiti


Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mgm.h
Libreria	Rtm.lib
DLL	Rtm.dll

Vedi anche

MgmGroupEnumerationEnd

MgmGroupEnumerationStart

SOURCE_GROUP_ENTRY

Share via