Функция 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.
Если функция завершается сбоем, возвращаемое значение может быть одним из следующих кодов ошибок.
| Код возврата | Описание |
|---|---|
|
Не удалось найти контроллеры домена. |
|
Указанный домен не является доверенным доменом. |
|
Клиентская сторона отношения доверия нарушена. |
|
Нарушена связь доверия на стороне сервера или поврежден пароль. |
|
Сервер, который ответил, не является надлежащим контроллером домена указанного домена. |
Комментарии
Для успешного выполнения функции NetGetAnyDCName специальное членство в группе не требуется.
Если servername указывает автономную рабочую станцию или автономный сервер, то доменное имя не является допустимым.
Если servername указывает рабочую станцию, которая является членом домена, или сервер, который является членом домена, имя домена должно находиться в том же домене, что и имя_сервера.
Если servername указывает контроллер домена, имя домена должно быть одним из доменов, доверенных для домена, для которого сервер является контроллером. Контроллер домена, который находит этот вызов, был в рабочем состоянии по крайней мере один раз во время этого вызова.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | lmaccess.h (включая Lm.h) |
| Библиотека | Netapi32.lib |
| DLL | Netapi32.dll |