NetScheduleJobDel, fonction (lmat.h)

Article
03/14/2023

[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