NetAddAlternateComputerName, fonction (lmjoin.h)

Article
08/24/2023

La fonction NetAddAlternateComputerName ajoute un autre nom pour l’ordinateur spécifié.

Syntaxe

NET_API_STATUS NET_API_FUNCTION NetAddAlternateComputerName(
  [in, optional] LPCWSTR Server,
  [in]           LPCWSTR AlternateName,
  [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] AlternateName

Pointeur vers une chaîne constante qui spécifie l’autre nom à ajouter. 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
ERROR_ACCESS_DENIED	Accès refusé. Cette erreur est retournée si l’appelant n’était pas membre du groupe local Administrateurs sur l’ordinateur cible.
ERROR_INVALID_NAME	Un paramètre name est incorrect. Cette erreur est retournée si le paramètre AlternateName ne contient pas de nom valide.
ERROR_INVALID_PARAMETER	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.
ERROR_NOT_ENOUGH_MEMORY	La mémoire disponible est insuffisante pour traiter cette commande.
ERROR_NOT_SUPPORTED	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.
NERR_WkstaNotStarted	Le service Station de travail n’a pas été démarré.
RPC_S_CALL_IN_PROGRESS	Un appel de procédure distante est déjà en cours pour ce thread.
RPC_S_PROTSEQ_NOT_SUPPORTED	La séquence de protocole d’appel de procédure distante n’est pas prise en charge.

Notes

La fonction NetAddAlternateComputerName est prise en charge sur Windows XP et versions ultérieures.

La fonction NetAddAlternateComputerName est utilisée pour définir des noms de réseau secondaires pour les ordinateurs. Le nom principal est le nom utilisé pour l’authentification et correspond au nom du compte de l’ordinateur.

La fonction NetAddAlternateComputerName nécessite que l’appelant soit membre du groupe local Administrateurs sur l’ordinateur cible.

Spécifications


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