NetMessageBufferSend, fonction (lmmsg.h)

Article
08/24/2023

[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 NetMessageBufferSend envoie une mémoire tampon d’informations à un alias de message inscrit.

Syntaxe

NET_API_STATUS NET_API_FUNCTION NetMessageBufferSend(
  [in] LPCWSTR servername,
  [in] LPCWSTR msgname,
  [in] LPCWSTR fromname,
  [in] LPBYTE  buf,
  [in] DWORD   buflen
);

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 auquel la mémoire tampon de message doit être envoyée.

[in] fromname

Pointeur vers une chaîne constante spécifiant d’où provient le message. Si ce paramètre a la valeur NULL, le message est envoyé à partir du nom de l’ordinateur local.

[in] buf

Pointeur vers une mémoire tampon qui contient le texte du message. Pour plus d’informations, consultez Mémoires tampons de fonction de gestion réseau.

[in] buflen

Spécifie une valeur qui contient la longueur, en octets, du texte du message pointé vers le paramètre buf .

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_NameNotFound	Le nom d’utilisateur est introuvable.
NERR_NetworkError	Une défaillance générale s’est produite dans le matériel réseau.

Notes

Si vous appelez cette fonction sur un contrôleur de domaine qui exécute Active Directory, l’accès est autorisé ou refusé en fonction de la liste de contrôle d’accès (ACL) de l’objet sécurisable. La liste de contrôle d’accès par défaut autorise uniquement les administrateurs de domaine et les opérateurs de compte à appeler cette fonction. Sur un serveur ou une station de travail membre, seuls les administrateurs et les opérateurs de serveur peuvent appeler cette fonction. Pour plus d’informations, consultez Exigences de sécurité pour les fonctions de gestion réseau. Pour plus d’informations sur les listes de contrôle d’accès et les ACL, consultez modèle Access Control.

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