SetNetScheduleAccountInformation, fonction (atacct.h)
[SetNetScheduleAccountInformation n’est plus disponible depuis Windows 8. Utilisez plutôt les interfaces Du planificateur de tâches 2.0.
]
La fonction SetNetScheduleAccountInformation définit le nom et le mot de passe du compte AT Service. Le nom et le mot de passe du compte AT Service sont utilisés comme informations d’identification pour les travaux planifiés créés avec NetScheduleJobAdd.
Syntaxe
HRESULT SetNetScheduleAccountInformation(
[in] LPCWSTR pwszServerName,
[in] LPCWSTR pwszAccount,
[in] LPCWSTR pwszPassword
);
Paramètres
[in] pwszServerName
Chaîne de caractères larges terminée par null pour le nom de l’ordinateur dont les informations de compte sont définies.
[in] pwszAccount
Pointeur vers une chaîne de caractères larges terminée par NULL pour le compte. Pour spécifier le compte système local, définissez ce paramètre sur NULL.
[in] pwszPassword
Pointeur vers une chaîne de caractères large terminée par NULL pour le mot de passe. Pour plus d’informations sur la sécurisation des informations de mot de passe, consultez Gestion des mots de passe.
Valeur retournée
La valeur de retour est un HRESULT. La valeur S_OK indique que le nom et le mot de passe du compte ont été correctement définis. Toute autre valeur indique une condition d’erreur.
Si la fonction échoue, certaines des valeurs de retour possibles sont répertoriées ci-dessous.
| Code/valeur de retour | Description |
|---|---|
|
L’accès a été refusé. Cette erreur est retournée si l’appelant n’était pas membre du groupe Administrateurs. Cette erreur est également retournée si le paramètre pwszAccount n’était pas NULL indiquant un compte nommé et non le compte système local et si le paramètre pwszPassword était incorrect pour le compte spécifié dans le paramètre pwszAccount . |
|
Données non valides. Cette erreur est retournée si le paramètre pwszPassword était NULL ou si la longueur de la chaîne de paramètre pwszPassword était trop longue. |
|
Impossible d’établir l’existence du compte spécifié. Cette erreur est retournée si le paramètre pwszAccount n’était pas NULL , indiquant un compte nommé et non le compte système local et si le paramètre pwszAccount est introuvable. |
Remarques
SetNetScheduleAccountInformation emprunte l’identité de l’appelant. Seuls les membres du groupe Administrateurs local sur l’ordinateur sur lequel les informations de compte de planification sont définies peuvent exécuter correctement cette fonction. Notez que les mots de passe NULL ne sont pas autorisés.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista, Windows XP avec SP1 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | atacct.h |
| Bibliothèque | Mstask.lib |
| DLL | Mstask.dll |