NetScheduleJobGetInfo, fonction (lmat.h)

[NetScheduleJobGetInfo 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 NetScheduleJobGetInfo récupère des informations sur un travail particulier mis en file d’attente sur un ordinateur spécifié. Cette fonction nécessite que le service de planification soit démarré.

Syntaxe

NET_API_STATUS NET_API_FUNCTION NetScheduleJobGetInfo(
  [in, optional] LPCWSTR Servername,
  [in]           DWORD   JobId,
  [out]          LPBYTE  *PointerToBuffer
);

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] JobId

Valeur qui indique l’identificateur du travail pour lequel récupérer des informations.

[out] PointerToBuffer

Pointeur vers la mémoire tampon qui reçoit la structure AT_INFO décrivant le travail spécifié. Cette mémoire tampon est allouée par le système et doit être libérée à l’aide de la fonction NetApiBufferFree . Pour plus d’informations, consultez Mémoires tampons de fonction de gestionréseau et Longueurs de mémoire tampon des fonctions de gestion réseau.

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 énuméré 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

Configuration requise

Voir aussi

AT_INFO

NetScheduleJobAdd

NetScheduleJobDel

NetScheduleJobEnum

Fonctions de gestion réseau

Vue d’ensemble de la gestion du réseau

Fonctions de planification