NetScheduleJobGetInfo, fonction (lmat.h)

Article
08/24/2023

[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 gestion ré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


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