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


Функция NetServerComputerNameAdd (lmserver.h)

Функция NetServerComputerNameAdd перечисляет транспорты, на которых активен указанный сервер, и привязывает эмулированное имя сервера к каждому транспорту.

NetServerComputerNameAdd — это служебная функция, объединяющая функции NetServerTransportEnum и NetServerTransportAddEx .

Синтаксис

NET_API_STATUS NET_API_FUNCTION NetServerComputerNameAdd(
  [in] LMSTR ServerName,
  [in] LMSTR EmulatedDomainName,
  [in] LMSTR EmulatedServerName
);

Параметры

[in] ServerName

Указатель на строку, указывающую имя удаленного сервера, на котором выполняется функция. Если этот параметр имеет значение NULL, используется локальный компьютер.

[in] EmulatedDomainName

Указатель на строку, содержащую доменное имя, которое указанный сервер должен использовать при объявлении о своем присутствии с помощью emulatedServerName. Этот параметр является необязательным.

[in] EmulatedServerName

Указатель на символьную строку, завершающуюся значением NULL, которая содержит эмулированное имя, которое сервер должен поддерживать в дополнение к имени, указанному параметром ServerName .

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет NERR_Success. Обратите внимание, что NetServerComputerNameAdd завершается успешно, если указанное эмулированное имя сервера добавляется хотя бы в один транспорт.

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

Код возврата Описание
ERROR_ACCESS_DENIED
Пользователь не имеет доступа к запрошенной информации.
ERROR_DUP_NAME
В сети существует повторяющееся имя.
ERROR_INVALID_DOMAINNAME
Не удалось найти доменное имя в сети.
ERROR_INVALID_PARAMETER
Указанный параметр недопустим.
ERROR_NOT_ENOUGH_MEMORY
Недостаточно памяти.

Комментарии

Только члены локальной группы Администраторы или Операторы сервера могут успешно выполнить функцию NetServerComputerNameAdd .

Сервер, указанный параметром ServerName , по-прежнему поддерживает все имена, которые он поддерживал, и, кроме того, начинает поддерживать новые имена, предоставленные при успешных вызовах функции NetServerComputerNameAdd .

Эмуляция имени, возникающая в результате вызова NetServerComputerNameAdd , прекращается при перезагрузке или перезапуске сервера. Чтобы отменить эмуляцию имени, заданную предыдущим вызовом NetServerComputerNameAdd без перезапуска или перезагрузки, можно вызвать функцию NetServerComputerNameDel .

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

Примеры

Ниже приведен пример вызова функции NetServerComputerNameAdd , запрашивающей, что \Server1 также отвечает на запросы для \Server2.

NetServerComputerNameAdd (Server1, NULL, Server2);

Требования

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

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

NetServerComputerNameDel

NetServerTransportAdd

NetServerTransportAddEx

NetServerTransportEnum

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

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

Функции сервера