NetMessageNameAdd, fonction (lmmsg.h)
[Cette fonction n’est pas prise en charge à partir de Windows Vista, car le service Messenger n’est pas pris en charge.]
La fonction NetMessageNameAdd inscrit un alias de message dans la table de noms de message. La fonction nécessite que le service de messagerie soit démarré.
Syntaxe
NET_API_STATUS NET_API_FUNCTION NetMessageNameAdd(
[in] LPCWSTR servername,
[in] LPCWSTR msgname
);
Paramètres
[in] servername
Pointeur vers une chaîne constante qui spécifie le nom DNS ou NetBIOS 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] msgname
Pointeur vers une chaîne constante qui spécifie l’alias de message à ajouter. La chaîne ne peut pas avoir plus de 15 caractères.
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.
| Code de retour | Description |
|---|---|
|
L’appelant n’a pas l’accès approprié pour terminer l’opération. |
|
Un paramètre est incorrect. |
|
Cette demande n’est pas prise en charge. Cette erreur est retournée sur Windows Vista et versions ultérieures. |
|
L’alias de message existe déjà sur cet ordinateur. Pour plus d'informations, consultez la section Notes qui suit. |
|
Le nom spécifié est déjà utilisé comme alias de message sur le réseau. |
|
Une défaillance générale s’est produite dans le matériel réseau. |
|
Le nombre maximal d’alias de message a été dépassé. |
Remarques
Seuls les membres du groupe local Administrateurs peuvent exécuter correctement la fonction NetMessageNameAdd sur un serveur distant.
L’indicateur d’action avant n’est plus un paramètre pour LAN Manager 2. Fonction xNetMessageNameAdd , car le transfert de messages n’est plus pris en charge. Si la fonction NetMessageNameAdd détecte qu’une version transférée de msgname existe sur le réseau, la fonction échoue avec une erreur NERR_Already_Exists.
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 | lmmsg.h (include Lm.h) |
| Bibliothèque | Netapi32.lib |
| DLL | Netapi32.dll |