Metodo IEnumWorkItems::Next (mstask.h)

Articolo
03/13/2024

[[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.

Codice restituito	Descrizione
S_OK	Il numero di attività recuperate è uguale al numero richiesto.
S_FALSE	Il numero restituito è minore del numero richiesto. Pertanto, non sono presenti altre attività da enumerare.
E_INVALIDARG	Un parametro non è valido.
E_OUTOFMEMORY	Memoria insufficiente.

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

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mstask.h
Libreria	Mstask.lib
DLL	Mstask.dll
Componente ridistribuibile	Internet Explorer 4.0 o versione successiva in Windows NT 4.0 e Windows 95