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


Функция NetGetAnyDCName (lmaccess.h)

Функция NetGetAnyDCName возвращает имя любого контроллера домена (DC) для домена, которому напрямую доверяет указанный сервер.

Приложения, поддерживающие имена в стиле DNS, должны вызывать функцию DsGetDcName . Эта функция может находить любой контроллер домена в любом домене, независимо от того, является ли домен напрямую доверенным для указанного сервера.

Синтаксис

NET_API_STATUS NET_API_FUNCTION NetGetAnyDCName(
        LPCWSTR ServerName,
        LPCWSTR DomainName,
        LPBYTE  *Buffer
);

Параметры

ServerName

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

DomainName

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

Buffer

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

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

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

Код возврата Описание
ERROR_NO_LOGON_SERVERS
Не удалось найти контроллеры домена.
ERROR_NO_SUCH_DOMAIN
Указанный домен не является доверенным доменом.
ERROR_NO_TRUST_LSA_SECRET
Клиентская сторона отношения доверия нарушена.
ERROR_NO_TRUST_SAM_ACCOUNT
Нарушена связь доверия на стороне сервера или поврежден пароль.
ERROR_DOMAIN_TRUST_INCONSISTENT
Сервер, который ответил, не является надлежащим контроллером домена указанного домена.

Комментарии

Для успешного выполнения функции NetGetAnyDCName специальное членство в группе не требуется.

Если servername указывает автономную рабочую станцию или автономный сервер, то доменное имя не является допустимым.

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

Если servername указывает контроллер домена, имя домена должно быть одним из доменов, доверенных для домена, для которого сервер является контроллером. Контроллер домена, который находит этот вызов, был в рабочем состоянии по крайней мере один раз во время этого вызова.

Требования

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

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

DsGetDcName

Получение функций

NetGetDCName

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

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