Funzione NetScheduleJobDel (lmat.h)
[NetScheduleJobDel non è più disponibile per l'uso a partire da Windows 8. Usare invece le interfacce dell'utilità di pianificazione 2.0.
]
La funzione NetScheduleJobDel elimina un intervallo di processi in coda da eseguire in un computer. Questa funzione richiede che il servizio di pianificazione venga avviato nel computer in cui viene inviata la richiesta di eliminazione del processo.
Sintassi
NET_API_STATUS NET_API_FUNCTION NetScheduleJobDel(
[in, optional] LPCWSTR Servername,
[in] DWORD MinJobId,
[in] DWORD MaxJobId
);
Parametri
[in, optional] Servername
Puntatore a una stringa costante che specifica il nome DNS o NetBIOS del server remoto in cui deve essere eseguita la funzione. Se questo parametro è NULL, viene utilizzato il computer locale.
[in] MinJobId
Identificatore minimo del processo. I processi con un identificatore di processo inferiore a MinJobId non verranno eliminati.
[in] MaxJobId
Identificatore massimo del processo. I processi con un identificatore di processo maggiore di MaxJobId non verranno eliminati.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene NERR_Success.
Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema. Per un elenco dei codici di errore, vedere Codici errore di sistema.
Commenti
In genere solo i membri del gruppo Administrators locale nel computer in cui viene eliminato il processo di pianificazione possono eseguire correttamente questa funzione. Se il nome del server passato nella stringa a cui punta il parametro Nomeserver è 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 bit meno significativo impostato (ad esempio, 0x00000001), gli utenti appartenenti al gruppo Operatori server possono eseguire correttamente questa funzione.
HKLM\System\CurrentControlSet\Control\Lsa\SubmitControl
Chiamare la funzione NetScheduleJobEnum per recuperare l'identificatore del processo per uno o più processi pianificati.
La funzione NetScheduleJobDel elimina tutti i processi i cui identificatori di processo si trovano nell'intervallo MinJobId tramite MaxJobId.
Per eliminare tutti i processi pianificati nel server, è possibile chiamare NetScheduleJobDel specificando MinJobId uguale a 0 e MaxJobId uguale a – 1. Per eliminare un processo, specificare l'identificatore del processo sia per il parametro MinJobId che per il parametro MaxJobId .
Requisiti
| 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 |