NetServerComputerNameAdd, fonction (lmserver.h)
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 |
---|---|
|
L’utilisateur n’a pas accès aux informations demandées. |
|
Un nom en double existe sur le réseau. |
|
Le nom de domaine est introuvable sur le réseau. |
|
Le paramètre spécifié n’est pas valide. |
|
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 |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour