Функция NetGetJoinableOUs (lmjoin.h)
Функция NetGetJoinableOUs извлекает список подразделений, в которых можно создать учетную запись компьютера.
Синтаксис
NET_API_STATUS NET_API_FUNCTION NetGetJoinableOUs(
[in] LPCWSTR lpServer,
[in] LPCWSTR lpDomain,
[in] LPCWSTR lpAccount,
[in] LPCWSTR lpPassword,
[out] DWORD *OUCount,
[out] LPWSTR **OUs
);
Параметры
[in] lpServer
Указатель на константную строку, указывающую DNS или NetBIOS-имя компьютера, на котором будет вызываться функция. Если этот параметр имеет значение NULL, используется локальный компьютер.
[in] lpDomain
Указатель на строку константы, указывающую имя домена, для которого требуется получить список подразделений, которые могут быть присоединены.
[in] lpAccount
Указатель на константную строку, указывающую имя учетной записи, используемой при подключении к контроллеру домена. В строке необходимо указать netBIOS-имя домена и учетную запись пользователя (например, "REDMOND\user") или имя участника-пользователя (UPN) пользователя в виде имени входа в интернет-стиле (например, "[email protected]"). Если этот параметр имеет значение NULL, используется контекст вызывающего объекта.
[in] lpPassword
Если параметр lpAccount указывает имя учетной записи, этот параметр должен указывать на пароль, используемый при подключении к контроллеру домена. В противном случае этот параметр должен иметь значение NULL.
[out] OUCount
Получает количество подразделений, возвращенных в списке объединяемых подразделений.
[out] OUs
Указатель на массив, получающий список объединяемых подразделений. Этот массив выделяется системой и должен быть освобожден с помощью одного вызова функции NetApiBufferFree . Дополнительные сведения см. в разделах Буферы функций управления сетью и Длина буфера функции управления сетью.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет NERR_Success.
Если функция завершается сбоем, возвращаемым значением может быть один из следующих кодов ошибок или один из кодов системных ошибок.
| Код возврата | Описание |
|---|---|
|
Недостаточно места для обработки этой команды. |
|
Конечный контроллер домена не поддерживает создание учетных записей компьютеров в подразделениях. |
Комментарии
Для успешного выполнения функции NetGetJoinableOUs не требуется специальное членство в группе.
Дополнительные сведения о подразделениях см. в разделе Управление пользователями в документации по Active Directory.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | lmjoin.h (включая Lm.h) |
| Библиотека | Netapi32.lib |
| DLL | Netapi32.dll |