NetServerComputerNameAdd, fonction (lmserver.h)

Article
02/28/2024

La fonction NetServerComputerNameAdd énumère les transports sur lesquels le serveur spécifié est actif et lie le nom du serveur émulé à chacun des transports.

NetServerComputerNameAdd est une fonction utilitaire qui combine les fonctionnalités de la fonction NetServerTransportEnum et de la fonction NetServerTransportAddEx .

Syntaxe

NET_API_STATUS NET_API_FUNCTION NetServerComputerNameAdd(
  [in] LMSTR ServerName,
  [in] LMSTR EmulatedDomainName,
  [in] LMSTR EmulatedServerName
);

Paramètres

[in] ServerName

Pointeur vers une chaîne qui spécifie le nom du serveur distant sur lequel la fonction doit s’exécuter. Si ce paramètre a la valeur NULL, l’ordinateur local est utilisé.

[in] EmulatedDomainName

Pointeur vers une chaîne qui contient le nom de domaine que le serveur spécifié doit utiliser lors de l’annonce de sa présence à l’aide de l’émulationNomserveur. Ce paramètre est facultatif.

[in] EmulatedServerName

Pointeur vers une chaîne de caractères terminée par null qui contient le nom émulé que le serveur doit commencer à prendre en charge en plus du nom spécifié par le paramètre ServerName .

Valeur retournée

Si la fonction réussit, la valeur de retour est NERR_Success. Notez que NetServerComputerNameAdd réussit si le nom de serveur émulé spécifié est ajouté à au moins un transport.

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

Code de retour	Description
ERROR_ACCESS_DENIED	L’utilisateur n’a pas accès aux informations demandées.
ERROR_DUP_NAME	Un nom en double existe sur le réseau.
ERROR_INVALID_DOMAINNAME	Le nom de domaine est introuvable sur le réseau.
ERROR_INVALID_PARAMETER	Le paramètre spécifié n’est pas valide.
ERROR_NOT_ENOUGH_MEMORY	La mémoire disponible est insuffisante.

Remarques

Seuls les membres du groupe local Administrateurs ou Opérateurs de serveur peuvent exécuter correctement la fonction NetServerComputerNameAdd .

Le serveur spécifié par le paramètre ServerName continue de prendre en charge tous les noms qu’il prenait en charge, et commence également à prendre en charge les nouveaux noms fournis par les appels réussis à la fonction NetServerComputerNameAdd .

L’émulation de nom qui résulte d’un appel à NetServerComputerNameAdd cesse lorsque le serveur redémarre ou redémarre. Pour arrêter l’émulation de nom définie par un appel précédent à NetServerComputerNameAdd sans redémarrer ni redémarrer, vous pouvez appeler la fonction NetServerComputerNameDel .

La fonction NetServerComputerNameAdd est généralement utilisée lorsqu’un administrateur système remplace un serveur, mais souhaite conserver la conversion transparente pour les utilisateurs.

Exemples

Voici un exemple d’appel à la fonction NetServerComputerNameAdd demandant que \Server1 réponde également aux demandes pour \Server2.

NetServerComputerNameAdd (Server1, NULL, Server2);

Configuration requise

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