Поделиться через


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

[Эта функция не поддерживается в 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
Псевдоним сообщения не находится на локальном компьютере.

Комментарии

Только члены локальной группы Администраторы могут успешно выполнять функцию NetMessageNameGetInfo на удаленном сервере.

Чтобы получить список всех псевдонимов сообщений в таблице имен сообщений, можно вызвать функцию NetMessageNameEnum .

Требования

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

См. также раздел

MSG_INFO_0

MSG_INFO_1

Функции сообщений

NetMessageNameEnum

Функции управления сетью

Общие сведения об управлении сетью