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

Статья
02/28/2024

Функция 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	Недостаточно памяти.

Сервер, указанный параметром 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