NetMessageNameDel, fonction (lmmsg.h)
[Cette fonction n’est pas prise en charge à partir de Windows Vista, car le service de messagerie n’est pas pris en charge.]
La fonction NetMessageNameDel supprime un alias de message dans la table du nom du message. La fonction nécessite que le service de messagerie soit démarré.
Syntaxe
NET_API_STATUS NET_API_FUNCTION NetMessageNameDel(
[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 à supprimer. 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. |
|
Un alias de message qui est également un nom d’ordinateur ne peut pas être supprimé. |
|
L’alias de message n’a pas été supprimé de tous les réseaux. |
|
L’alias de message est actuellement utilisé. Réessayez plus tard. |
|
L’alias de message n’est pas sur l’ordinateur local. |
Notes
Seuls les membres du groupe local Administrateurs peuvent exécuter correctement la fonction NetMessageNameDel sur un serveur distant.
Spécifications
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 (inclure Lm.h) |
Bibliothèque | Netapi32.lib |
DLL | Netapi32.dll |