Metodo IEnumTASK::Next (mmc.h)

Articolo
08/24/2023

Il metodo IEnumTASK::Next consente a MMC di recuperare l'attività successiva nell'elenco di attività dello snap-in.

Sintassi

HRESULT Next(
  [in]  ULONG    celt,
  [out] MMC_TASK *rgelt,
  [out] ULONG    *pceltFetched
);

Parametri

[in] celt

Valore che specifica il numero di attività da fornire. MMC enumera sempre le attività una alla volta; pertanto, celt è sempre 1.

[out] rgelt

Puntatore a una struttura MMC_TASK compilata dallo snap-in per rappresentare l'attività da aggiungere al taskpad. Tenere presente che il chiamante (MMC) alloca la memoria per la struttura.

[out] pceltFetched

Puntatore a un valore che specifica il numero di attività restituite. Se lo snap-in ha restituito correttamente una o più attività, impostare il valore sul numero di attività restituite correttamente. Poiché MMC richiede sempre un'attività alla volta (celt è sempre 1), pceltFetched deve essere impostato su 1 se l'attività è stata restituita correttamente. Se lo snap-in non contiene più attività nell'elenco o se lo snap-in non riesce a compilare la struttura MMC_TASK, impostare il valore su 0.

Valore restituito

Questo metodo può restituire uno di questi valori.

Commenti

MMC chiama questo metodo per enumerare l'elenco di attività che lo snap-in deve aggiungere al Blocco attività. MMC chiama questo metodo fino a quando non restituisce S_FALSE per indicare che non sono presenti altre attività per lo snap-in da aggiungere al Blocco attività.