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

  • Статья

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

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

Синтаксис

NET_API_STATUS NET_API_FUNCTION NetMessageNameAdd(
  [in] LPCWSTR servername,
  [in] LPCWSTR msgname
);

Параметры

[in] servername

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

[in] msgname

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

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

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

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

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

Комментарии

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

Флаг действия пересылки больше не является параметром для диспетчера локальной сети 2. Функцияx NetMessageNameAdd , так как переадресация сообщений больше не поддерживается. Если функция NetMessageNameAdd обнаруживает, что в сети существует пересылаемая версия msgname , функция завершится ошибкой NERR_Already_Exists.

Требования

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

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

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

NetMessageNameDel

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

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