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


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

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

Код возврата Описание
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
Последовательность протокола удаленного вызова процедур не поддерживается.

Комментарии

Функция NetRemoveAlternateComputerName поддерживается в Windows XP и более поздних версиях.

Функция NetRemoveAlternateComputerName используется для удаления имен дополнительных компьютеров, настроенных для целевого компьютера.

Функция NetRemoveAlternateComputerName требует, чтобы вызывающий объект был членом локальной группы администраторов на целевом компьютере.

Требования

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

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

NetAddAlternateComputerName

NetEnumerateComputerNames

NetJoinDomain

NetRenameMachineInDomain

NetSetPrimaryComputerName

NetUnjoinDomain

SetComputerNameEx