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

Статья
08/24/2023

Функция 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	Сервер, который ответил, не является надлежащим контроллером домена указанного домена.

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

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

Требования

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