Partager via


NetMessageNameGetInfo, 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 NetMessageNameGetInfo récupère des informations sur un alias de message particulier 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 NetMessageNameGetInfo(
  [in]  LPCWSTR servername,
  [in]  LPCWSTR msgname,
  [in]  DWORD   level,
  [out] LPBYTE  *bufptr
);

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 pour lequel retourner des informations.

[in] level

Spécifie le niveau d’informations des données. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
0
Retourne l’alias de message. Le paramètre bufptr pointe vers une structure MSG_INFO_0 .
1
Retourne l’alias de message. Le paramètre bufptr pointe vers une structure MSG_INFO_1 . Ce niveau existe uniquement pour la compatibilité. Le transfert de messages n’est pas pris en charge.

[out] bufptr

Pointeur vers la mémoire tampon qui reçoit les données. Le format de ces données dépend de la valeur du paramètre de niveau . Cette mémoire tampon est allouée par le système et doit être libérée à l’aide de la fonction NetApiBufferFree . Pour plus d’informations, consultez Mémoires tampons de fonction de gestionréseau et Longueurs de mémoire tampon des fonctions de gestion réseau.

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_LEVEL
La valeur spécifiée pour le paramètre de niveau n’est pas valide.
ERROR_INVALID_PARAMETER
Un paramètre est incorrect.
ERROR_NOT_ENOUGH_MEMORY
La mémoire disponible est insuffisante.
ERROR_NOT_SUPPORTED
Cette demande n’est pas prise en charge. Cette erreur est retournée sur Windows Vista et versions ultérieures.
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 NetMessageNameGetInfo sur un serveur distant.

Pour répertorier tous les alias de message dans une table de noms de message, vous pouvez appeler la fonction NetMessageNameEnum .

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

MSG_INFO_0

MSG_INFO_1

Fonctions de message

NetMessageNameEnum

Fonctions de gestion réseau

Vue d’ensemble de la gestion du réseau