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