SetNetScheduleAccountInformation, fonction (atacct.h)

Article
02/23/2024

[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
E_ACCESSDENIED 0x080070005	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 .
HRESULT_FROM_WIN32(ERROR_INVALID_DATA) 0x08007000d	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.
SCHED_E_ACCOUNT_NAME_NOT_FOUND 0x80041310	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

Voir aussi

GetNetScheduleAccountInformation