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

Статья
08/24/2023

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

Требования


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

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

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

NetMessageNameAdd

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

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