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