Funzione NetScheduleJobEnum (lmat.h)

Articolo
03/14/2023

[NetScheduleJobEnum non è più disponibile per l'uso a partire da Windows 8. Usare invece le interfacce dell'utilità di pianificazione 2.0.

]

La funzione NetScheduleJobEnum elenca i processi accodati in un computer specificato. Questa funzione richiede l'avvio del servizio di pianificazione.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetScheduleJobEnum(
  [in, optional] LPCWSTR Servername,
  [out]          LPBYTE  *PointerToBuffer,
  [in]           DWORD   PrefferedMaximumLength,
  [out]          LPDWORD EntriesRead,
  [out]          LPDWORD TotalEntries,
  [in, out]      LPDWORD ResumeHandle
);

Parametri

[in, optional] Servername

Puntatore a una stringa costante che specifica il nome DNS o NetBIOS del server remoto in cui eseguire la funzione. Se questo parametro è NULL, viene usato il computer locale.

[out] PointerToBuffer

Puntatore al buffer che riceve i dati. Le informazioni restituite sono una matrice di strutture AT_ENUM . Il buffer viene allocato dal sistema e deve essere liberato usando una singola chiamata alla funzione NetApiBufferFree . Si noti che è necessario liberare il buffer anche se la funzione ha esito negativo con ERROR_MORE_DATA.

[in] PrefferedMaximumLength

Valore che indica la lunghezza massima preferita dei dati restituiti, in byte. Se si specifica MAX_PREFERRED_LENGTH, la funzione alloca la quantità di memoria necessaria per i dati. Se si specifica un altro valore in questo parametro, può limitare il numero di byte restituiti dalla funzione. Se le dimensioni del buffer non sono sufficienti per contenere tutte le voci, la funzione restituisce ERROR_MORE_DATA. Per altre informazioni, vedere Buffer delle funzioni di gestione della rete e lunghezze del buffer delle funzioni di gestione della rete.

[out] EntriesRead

Puntatore a un valore che riceve il conteggio degli elementi effettivamente enumerati.

[out] TotalEntries

Puntatore a un valore che riceve il numero totale di voci che potrebbero essere state enumerate dalla posizione di ripresa corrente. Si noti che le applicazioni devono considerare questo valore solo come hint.

[in, out] ResumeHandle

Puntatore a un valore contenente un handle di ripresa utilizzato per continuare un'enumerazione del processo. L'handle deve essere zero nella prima chiamata e lasciato invariato per le chiamate successive. Se questo parametro è NULL, non viene archiviato alcun handle di ripresa.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NERR_Success.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema. Per un elenco di codici di errore, vedere Codici di errore di sistema.

Commenti

In genere solo i membri del gruppo Administrators locale nel computer in cui viene enumerato il processo di pianificazione possono eseguire correttamente questa funzione. Se il nome del server passato nella stringa a cui fa riferimento il parametro Nome server è un server remoto, solo i membri del gruppo Administrators locale nel server possono eseguire correttamente questa funzione.

Se il valore del Registro di sistema seguente ha il set di bit meno significativo (ad esempio, 0x00000001), gli utenti appartenenti al gruppo Operatori server possono anche eseguire correttamente questa funzione.

HKLM\System\CurrentControlSet\Control\Lsa\SubmitControl

Ogni voce restituita contiene una struttura AT_ENUM . Il valore del membro JobId può essere usato quando si chiamano funzioni che richiedono un parametro di identificatore del processo, ad esempio la funzione NetScheduleJobDel .

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	lmat.h (include Lmat.h)
Libreria	Netapi32.lib
DLL	Netapi32.dll