NetSetPrimaryComputerName, fonction (lmjoin.h)
La fonction NetSetPrimaryComputerName définit le nom de l’ordinateur principal de l’ordinateur spécifié.
Syntaxe
NET_API_STATUS NET_API_FUNCTION NetSetPrimaryComputerName(
[in, optional] LPCWSTR Server,
[in] LPCWSTR PrimaryName,
[in, optional] LPCWSTR DomainAccount,
[in, optional] LPCWSTR DomainAccountPassword,
[in] ULONG Reserved
);
Paramètres
[in, optional] Server
Pointeur vers une chaîne constante qui spécifie le nom de l’ordinateur sur lequel exécuter cette fonction. Si ce paramètre a la valeur NULL, l’ordinateur local est utilisé.
[in] PrimaryName
Pointeur vers une chaîne constante qui spécifie le nom principal à définir. Ce nom doit être sous la forme d’un nom DNS complet.
[in, optional] DomainAccount
Pointeur vers une chaîne constante qui spécifie le compte de domaine à utiliser pour accéder à l’objet de compte d’ordinateur pour l’ordinateur spécifié dans le paramètre Serveur dans Active Directory. Si ce paramètre a la valeur NULL, les informations d’identification de l’utilisateur exécutant cette routine sont utilisées.
Ce paramètre n’est pas utilisé si le serveur pour exécuter cette fonction n’est pas joint à un domaine.
[in, optional] DomainAccountPassword
Pointeur vers une chaîne constante qui spécifie le mot de passe correspondant au compte de domaine passé dans le paramètre DomainAccount . Si ce paramètre a la valeur NULL, les informations d’identification de l’utilisateur exécutant cette routine sont utilisées.
Ce paramètre est ignoré si le paramètre DomainAccount a la valeur NULL. Ce paramètre n’est pas utilisé si le serveur pour exécuter cette fonction n’est pas joint à un domaine.
[in] Reserved
Réservé pour un usage futur. Ce paramètre doit être NULL.
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 |
|---|---|
|
L’accès est refusé. Cette erreur est retournée si l’appelant n’était pas membre du groupe local Administrateurs sur l’ordinateur cible. |
|
Un paramètre name est incorrect. Cette erreur est retournée si le paramètre PrimaryName ne contient pas de nom valide. |
|
Un paramètre est incorrect. Cette erreur est retournée si le paramètre DomainAccount ne contient pas de domaine valide. Cette erreur est également retournée si le paramètre DomainAccount n’a pas la valeur NULL et que le paramètre DomainAccountPassword n’est pas NULL , mais ne contient pas de chaîne Unicode. |
|
La mémoire disponible est insuffisante pour traiter cette commande. |
|
La demande n'est pas prise en charge. Cette erreur est retournée si l’ordinateur cible spécifié dans le paramètre Server sur lequel cette fonction s’exécute s’exécute sur Windows 2000 et versions antérieures. |
|
Le service Station de travail n’a pas été démarré. |
|
Un appel de procédure distante est déjà en cours pour ce thread. |
|
La séquence de protocole d’appel de procédure distante n’est pas prise en charge. |
Remarques
La fonction NetSetPrimaryComputerName est prise en charge sur Windows XP et versions ultérieures.
La fonction NetSetPrimaryComputerName est utilisée dans le cadre des opérations de renommage de l’ordinateur. Le nom spécifié sera supprimé de la liste des autres noms configurée pour l’ordinateur cible et configurée comme nom principal. Le nom du compte d’ordinateur sera modifié pour correspondre au nom principal. Le nom de l’ordinateur principal précédent est déplacé vers la liste de noms d’ordinateurs de remplacement configurée pour l’ordinateur.
La fonction NetSetPrimaryComputerName nécessite que l’appelant soit membre du groupe local Administrateurs sur l’ordinateur cible.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | lmjoin.h (include Lm.h) |
| Bibliothèque | Netapi32.lib |
| DLL | Netapi32.dll |