Metodo IEnumWorkItems::Next (mstask.h)

[[Questa API può essere modificata o non disponibile nelle versioni successive del sistema operativo o del prodotto. Usare invece le interfacce dell'Utilità di pianificazione 2.0 . ]

Recupera il numero specificato successivo di attività nella sequenza di enumerazione.

Se nella sequenza sono rimasti meno del numero di attività richiesto, vengono recuperati tutti gli elementi rimanenti.

Sintassi

HRESULT Next(
  [in]  ULONG  celt,
  [out] LPWSTR **rgpwszNames,
  [out] ULONG  *pceltFetched
);

Parametri

[in] celt

Numero di attività da recuperare.

[out] rgpwszNames

Puntatore a una matrice di puntatori (LPWSTR) a stringhe di caratteri con terminazione Null contenenti i nomi di file delle attività restituite dalla sequenza di enumerazione. Questi nomi di file provengono dalla cartella Attività pianificate e hanno l'estensione ".job".

Dopo aver elaborato i nomi restituiti in rgpwszNames, è prima necessario liberare ogni stringa di caratteri nella matrice e quindi la matrice stessa usando CoTaskMemFree.

[out] pceltFetched

Puntatore al numero di attività restituite in rgpwszNames. Se il parametro celt è 1, questo parametro può essere NULL.

Valore restituito

Restituisce uno dei valori seguenti.

Commenti

L'interfaccia IEnumWorkItems fornisce anche metodi per reimpostare l'enumerazione, ignorare le attività e creare una copia dello stato corrente dell'enumerazione.

Esempio

Per un esempio di come usare Next per enumerare le attività nella cartella Attività pianificate, vedere Enumerating Tasks Example .For an example of how to use Next to enumerate the tasks in the Scheduled Tasks folder, see Enumerating Tasks Example.

Requisiti

Vedi anche

IEnumWorkItems

IEnumWorkItems::Clone

IEnumWorkItems::Reset

IEnumWorkItems::Skip