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
ERROR_ACCESS_DENIED
L’appelant n’a pas l’accès approprié pour terminer l’opération.
ERROR_INVALID_PARAMETER
Un paramètre est incorrect.
ERROR_NOT_SUPPORTED
Cette demande n’est pas prise en charge. Cette erreur est retournée sur Windows Vista et versions ultérieures.
NERR_DelComputerName
Un alias de message qui est également un nom d’ordinateur ne peut pas être supprimé.
NERR_IncompleteDel
L’alias de message n’a pas été supprimé de tous les réseaux.
NERR_NameInUse
L’alias de message est actuellement utilisé. Réessayez plus tard.
NERR_NotLocalName
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

Voir aussi

Fonctions de message

NetMessageNameAdd

Fonctions de gestion réseau

Vue d’ensemble de la gestion du réseau