NetScheduleJobDel, fonction (lmat.h)
[NetScheduleJobDel n’est plus disponible pour une utilisation à partir de Windows 8. Utilisez plutôt les interfaces Du planificateur de tâches 2.0.
]
La fonction NetScheduleJobDel supprime une plage de travaux mis en file d’attente pour s’exécuter sur un ordinateur. Cette fonction nécessite que le service de planification soit démarré sur l’ordinateur auquel la demande de suppression de travail est envoyée.
Syntaxe
NET_API_STATUS NET_API_FUNCTION NetScheduleJobDel(
[in, optional] LPCWSTR Servername,
[in] DWORD MinJobId,
[in] DWORD MaxJobId
);
Paramètres
[in, optional] Servername
Pointeur vers une chaîne constante qui spécifie le nom DNS ou NetBIOS du serveur distant sur lequel la fonction doit s’exécuter. Si ce paramètre a la valeur NULL, l’ordinateur local est utilisé.
[in] MinJobId
Identificateur de travail minimal. Les travaux dont l’identificateur de travail est inférieur à MinJobId ne seront pas supprimés.
[in] MaxJobId
Identificateur de travail maximal. Les travaux dont l’identificateur de travail est supérieur à MaxJobId ne seront pas supprimés.
Valeur retournée
Si la fonction réussit, la valeur de retour est NERR_Success.
Si la fonction échoue, la valeur de retour est un code d’erreur système. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur système.
Notes
Normalement, seuls les membres du groupe Administrateurs local sur l’ordinateur sur lequel le travail de planification est en cours de suppression peuvent exécuter correctement cette fonction. Si le nom de serveur transmis dans la chaîne pointée par le paramètre Servername est un serveur distant, seuls les membres du groupe Administrateurs local sur le serveur peuvent exécuter correctement cette fonction.
Si la valeur de Registre suivante a le bit le moins significatif défini (par exemple, 0x00000001), les utilisateurs appartenant au groupe Opérateurs de serveur peuvent également exécuter correctement cette fonction.
HKLM\System\CurrentControlSet\Control\Lsa\SubmitControl
Appelez la fonction NetScheduleJobEnum pour récupérer l’identificateur de travail pour un ou plusieurs travaux planifiés.
La fonction NetScheduleJobDel supprime tous les travaux dont les identificateurs de travail se trouvent entre MinJobId et MaxJobId.
Pour supprimer tous les travaux planifiés sur le serveur, vous pouvez appeler NetScheduleJobDel en spécifiant MinJobId égal à 0 et MaxJobId égal à – 1. Pour supprimer un travail, spécifiez l’identificateur du travail pour les paramètres MinJobId et MaxJobId .
Configuration requise
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | lmat.h (include Lmat.h) |
| Bibliothèque | Netapi32.lib |
| DLL | Netapi32.dll |