Функция NetRemoveAlternateComputerName (lmjoin.h)
Функция NetRemoveAlternateComputerName удаляет альтернативное имя для указанного компьютера.
Синтаксис
NET_API_STATUS NET_API_FUNCTION NetRemoveAlternateComputerName(
[in, optional] LPCWSTR Server,
[in] LPCWSTR AlternateName,
[in, optional] LPCWSTR DomainAccount,
[in, optional] LPCWSTR DomainAccountPassword,
[in] ULONG Reserved
);
Параметры
[in, optional] Server
Указатель на константную строку, указывающую имя компьютера, на котором выполняется эта функция. Если этот параметр имеет значение NULL, используется локальный компьютер.
[in] AlternateName
Указатель на строку константы, указывающую альтернативное имя для удаления. Это имя должно быть в виде полного DNS-имени.
[in, optional] DomainAccount
Указатель на константную строку, указывающую учетную запись домена, используемую для доступа к объекту учетной записи компьютера для компьютера, указанного в параметре Server в Active Directory. Если этот параметр имеет значение NULL, используются учетные данные пользователя, выполняющего эту подпрограмму.
Этот параметр не используется, если сервер для выполнения этой функции не присоединен к домену.
[in, optional] DomainAccountPassword
Указатель на константную строку, указывающую пароль, соответствующий учетной записи домена, переданной в параметре DomainAccount . Если этот параметр имеет значение NULL, используются учетные данные пользователя, выполняющего эту подпрограмму.
Этот параметр игнорируется, если параметр DomainAccount имеет значение NULL. Этот параметр не используется, если сервер для выполнения этой функции не присоединен к домену.
[in] Reserved
Зарезервировано для последующего использования. Этот параметр должен иметь значение NULL.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет NERR_Success.
Если функция завершается сбоем, возвращаемым значением может быть один из следующих кодов ошибок или один из кодов системных ошибок.
| Код возврата | Описание |
|---|---|
|
Отказано в доступе". Эта ошибка возвращается, если вызывающий объект не был членом локальной группы "Администраторы" на целевом компьютере. |
|
Неправильный параметр имени. Эта ошибка возвращается, если параметр AlternateName не содержит допустимого имени. |
|
Неправильный параметр. Эта ошибка возвращается, если параметр DomainAccount не содержит допустимый домен. Эта ошибка также возвращается, если параметр DomainAccount не имеет значения NULL , а параметр DomainAccountPassword не имеет значения NULL , но не содержит строку Юникода. |
|
Недостаточно памяти для обработки этой команды. |
|
Запрос не поддерживается. Эта ошибка возвращается, если целевой компьютер, указанный в параметре Server , на котором выполняется эта функция, работает в Windows 2000 и более ранних версиях. |
|
Служба рабочей станции не запущена. |
|
Удаленный вызов процедуры для этого потока уже выполняется. |
|
Последовательность протокола удаленного вызова процедур не поддерживается. |
Комментарии
Функция NetRemoveAlternateComputerName поддерживается в Windows XP и более поздних версиях.
Функция NetRemoveAlternateComputerName используется для удаления имен дополнительных компьютеров, настроенных для целевого компьютера.
Функция NetRemoveAlternateComputerName требует, чтобы вызывающий объект был членом локальной группы администраторов на целевом компьютере.
Требования
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | lmjoin.h (включая Lm.h) |
| Библиотека | Netapi32.lib |
| DLL | Netapi32.dll |