Функция NetRemoveAlternateComputerName (lmjoin.h)

Статья
08/24/2023

Функция 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.

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

Код возврата	Описание
ERROR_ACCESS_DENIED	Отказано в доступе". Эта ошибка возвращается, если вызывающий объект не был членом локальной группы "Администраторы" на целевом компьютере.
ERROR_INVALID_NAME	Неправильный параметр имени. Эта ошибка возвращается, если параметр AlternateName не содержит допустимого имени.
ERROR_INVALID_PARAMETER	Неправильный параметр. Эта ошибка возвращается, если параметр DomainAccount не содержит допустимый домен. Эта ошибка также возвращается, если параметр DomainAccount не имеет значения NULL , а параметр DomainAccountPassword не имеет значения NULL , но не содержит строку Юникода.
ERROR_NOT_ENOUGH_MEMORY	Недостаточно памяти для обработки этой команды.
ERROR_NOT_SUPPORTED	Запрос не поддерживается. Эта ошибка возвращается, если целевой компьютер, указанный в параметре Server , на котором выполняется эта функция, работает в Windows 2000 и более ранних версиях.
NERR_WkstaNotStarted	Служба рабочей станции не запущена.
RPC_S_CALL_IN_PROGRESS	Удаленный вызов процедуры для этого потока уже выполняется.
RPC_S_PROTSEQ_NOT_SUPPORTED	Последовательность протокола удаленного вызова процедур не поддерживается.

Требования


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