Функция 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
Задает уровень информации данных. Этот параметр может принимать одно из указанных ниже значений.
| Значение | Значение |
|---|---|
|
Возврат псевдонима сообщения. Параметр bufptr указывает на структуру MSG_INFO_0 . |
|
Возврат псевдонима сообщения. Параметр bufptr указывает на структуру MSG_INFO_1 . Этот уровень существует только для обеспечения совместимости. Переадресация сообщений не поддерживается. |
[out] bufptr
Указатель на буфер, который получает данные. Формат этих данных зависит от значения параметра level . Этот буфер выделяется системой и должен быть освобожден с помощью функции NetApiBufferFree . Дополнительные сведения см. в разделах Буферы функций управления сетью и Длина буфера функции управления сетью.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет NERR_Success.
Если функция завершается ошибкой, возвращаемое значение может быть одним из следующих кодов ошибок.
| Код возврата | Описание |
|---|---|
|
Вызывающий объект не имеет соответствующего доступа для завершения операции. |
|
Недопустимое значение, указанное для параметра level . |
|
Неправильный параметр. |
|
Недостаточно памяти. |
|
Этот запрос не поддерживается. Эта ошибка возвращается в Windows Vista и более поздних версиях. |
|
Псевдоним сообщения не находится на локальном компьютере. |
Комментарии
Только члены локальной группы Администраторы могут успешно выполнять функцию NetMessageNameGetInfo на удаленном сервере.
Чтобы получить список всех псевдонимов сообщений в таблице имен сообщений, можно вызвать функцию NetMessageNameEnum .
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | lmmsg.h (включая Lm.h) |
| Библиотека | Netapi32.lib |
| DLL | Netapi32.dll |