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

Статья
08/24/2023

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

Функция NetMessageNameGetInfo извлекает сведения о конкретном псевдониме сообщения в таблице имен сообщений. Функция требует запуска службы messenger.

Синтаксис

NET_API_STATUS NET_API_FUNCTION NetMessageNameGetInfo(
  [in]  LPCWSTR servername,
  [in]  LPCWSTR msgname,
  [in]  DWORD   level,
  [out] LPBYTE  *bufptr
);

Параметры

[in] servername

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

[in] msgname

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

[in] level

Задает уровень информации данных. Этот параметр может принимать одно из указанных ниже значений.

Значение	Значение
0	Возврат псевдонима сообщения. Параметр bufptr указывает на структуру MSG_INFO_0 .
1	Возврат псевдонима сообщения. Параметр bufptr указывает на структуру MSG_INFO_1 . Этот уровень существует только для обеспечения совместимости. Переадресация сообщений не поддерживается.

[out] bufptr

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

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

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

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

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

Требования


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