NetRenameMachineInDomain, fonction (lmjoin.h)

Article
08/24/2023

La fonction NetRenameMachineInDomain modifie le nom d’un ordinateur dans un domaine.

Syntaxe

NET_API_STATUS NET_API_FUNCTION NetRenameMachineInDomain(
  [in] LPCWSTR lpServer,
  [in] LPCWSTR lpNewMachineName,
  [in] LPCWSTR lpAccount,
  [in] LPCWSTR lpPassword,
  [in] DWORD   fRenameOptions
);

Paramètres

[in] lpServer

Pointeur vers une chaîne constante qui spécifie le nom DNS ou NetBIOS de l’ordinateur sur lequel appeler la fonction. Si ce paramètre a la valeur NULL, l’ordinateur local est utilisé.

[in] lpNewMachineName

Pointeur vers une chaîne constante qui spécifie le nouveau nom de l’ordinateur. S’il est spécifié, le nom de l’ordinateur local est également modifié. Si ce paramètre a la valeur NULL, la fonction suppose que vous avez déjà appelé la fonction SetComputerNameEx .

[in] lpAccount

Pointeur vers une chaîne constante qui spécifie un nom de compte à utiliser lors de la connexion au contrôleur de domaine. Si ce paramètre a la valeur NULL, le contexte de l’appelant est utilisé.

[in] lpPassword

Si le paramètre lpAccount spécifie un nom de compte, ce paramètre doit pointer vers le mot de passe à utiliser lors de la connexion au contrôleur de domaine. Sinon, ce paramètre doit avoir la valeur NULL.

[in] fRenameOptions

Options de renommage. Si ce paramètre est NETSETUP_ACCT_CREATE, la fonction renomme le compte dans le domaine.

Valeur retournée

Si la fonction réussit, la valeur de retour est NERR_Success.

Si la fonction échoue, la valeur de retour peut être l’un des codes d’erreur suivants ou l’un des codes d’erreur système.

Code de retour	Description
ERROR_ACCESS_DENIED	Accès refusé. Cette erreur est retournée si le nom du compte transmis dans le paramètre lpAccount ne disposait pas de droits d’accès suffisants pour l’opération.
ERROR_INVALID_PARAMETER	Un paramètre est incorrect.
NERR_SetupNotJoined	L’ordinateur n’est actuellement pas joint à un domaine.
NERR_SetupDomainController	Cet ordinateur est un contrôleur de domaine et ne peut pas être dissocié d’un domaine.

Notes

Le renommage d’un ordinateur de domaine ne peut être effectué que par un utilisateur qui est membre du groupe administrateurs local sur l’ordinateur cible et qui est également membre du groupe Administrateurs sur le domaine ou qui dispose du privilège Opérateur de compte sur le domaine. Si vous appelez la fonction NetRenameMachineInDomain à distance, vous devez fournir des informations d’identification, car vous ne pouvez pas déléguer d’informations d’identification dans ces circonstances.

Différents processus, ou différents threads du même processus, ne doivent pas appeler la fonction NetRenameMachineInDomain en même temps. Cette situation peut laisser l’ordinateur dans un état incohérent.

Les valeurs de retour NERR_SetupNotJoined et NERR_SetupDomainController sont définies dans le fichier d’en-tête Lmerr.h. Ce fichier d’en-tête est automatiquement inclus par le fichier d’en-tête Lm.h et ne doit pas être inclus directement.

Un redémarrage du système est nécessaire après l’appel de la fonction NetRenameMachineInDomain pour que l’opération se termine.

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	lmjoin.h (include Lm.h)
Bibliothèque	Netapi32.lib
DLL	Netapi32.dll