Функция NetMessageBufferSend (lmmsg.h)
[Эта функция не поддерживается в 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.
Если функция завершается ошибкой, возвращаемое значение может быть одним из следующих кодов ошибок.
Код возврата | Описание |
---|---|
|
Вызывающий объект не имеет соответствующего доступа для завершения операции. |
|
Неправильный параметр. |
|
Этот запрос не поддерживается. Эта ошибка возвращается в Windows Vista и более поздних версиях. |
|
Не удалось найти имя пользователя. |
|
На сетевом оборудовании произошел общий сбой. |
Комментарии
Если вы вызываете эту функцию на контроллере домена под управлением Active Directory, доступ разрешен или запрещен на основе списка управления доступом (ACL) для защищаемого объекта. Список управления доступом по умолчанию разрешает вызывать эту функцию только администраторам домена и операторам учетных записей. На рядовом сервере или рабочей станции эту функцию могут вызывать только администраторы и операторы сервера. Дополнительные сведения см. в разделе Требования к безопасности для функций управления сетями. Дополнительные сведения о списках управления доступом и ACE см. в разделе модель контроль доступа.
Требования
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | lmmsg.h (включая Lm.h) |
Библиотека | Netapi32.lib |
DLL | Netapi32.dll |