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


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

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

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

Синтаксис

NET_API_STATUS NET_API_FUNCTION NetMessageNameDel(
  [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_DelComputerName
Невозможно удалить псевдоним сообщения, который также является именем компьютера.
NERR_IncompleteDel
Псевдоним сообщения не был успешно удален из всех сетей.
NERR_NameInUse
В настоящее время используется псевдоним сообщения. Повторите попытку позже.
NERR_NotLocalName
Псевдоним сообщения не находится на локальном компьютере.

Комментарии

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

Требования

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

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

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

NetMessageNameAdd

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

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