Функция NetMessageBufferSend (lmmsg.h)

Статья
03/14/2023

[Эта функция не поддерживается в Windows Vista, так как служба messenger не поддерживается.]

Функция NetMessageBufferSend отправляет буфер данных в псевдоним зарегистрированного сообщения.

Синтаксис

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

Параметры

[in] servername

Указатель на строку константы, указывающую DNS или NetBIOS-имя удаленного сервера, на котором выполняется функция. Если этот параметр имеет значение NULL, используется локальный компьютер.

[in] msgname

Указатель на константную строку, указывающую псевдоним сообщения, в который должен быть отправлен буфер сообщений.

[in] fromname

Указатель на константную строку, указывающую, от кого получено сообщение. Если этот параметр имеет значение NULL, сообщение отправляется из имени локального компьютера.

[in] buf

Указатель на буфер, содержащий текст сообщения. Дополнительные сведения см. в разделе Буферы функций управления сетью.

[in] buflen

Задает значение, содержащее длину (в байтах) текста сообщения, на который указывает параметр buf .

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет NERR_Success.

Если функция завершается ошибкой, возвращаемое значение может быть одним из следующих кодов ошибок.

Код возврата	Описание
ERROR_ACCESS_DENIED	Вызывающий объект не имеет соответствующего доступа для завершения операции.
ERROR_INVALID_PARAMETER	Неправильный параметр.
ERROR_NOT_SUPPORTED	Этот запрос не поддерживается. Эта ошибка возвращается в Windows Vista и более поздних версиях.
NERR_NameNotFound	Не удалось найти имя пользователя.
NERR_NetworkError	На сетевом оборудовании произошел общий сбой.

Если вы вызываете эту функцию на контроллере домена под управлением Active Directory, доступ разрешен или запрещен на основе списка управления доступом (ACL) для защищаемого объекта. Список управления доступом по умолчанию разрешает вызывать эту функцию только администраторам домена и операторам учетных записей. На рядовом сервере или рабочей станции эту функцию могут вызывать только администраторы и операторы сервера. Дополнительные сведения см. в разделе Требования к безопасности для функций управления сетями. Дополнительные сведения о списках управления доступом и ACE см. в разделе модель контроль доступа.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	lmmsg.h (включая Lm.h)
Библиотека	Netapi32.lib
DLL	Netapi32.dll