Функция NetGetJoinableOUs (lmjoin.h)

Статья
08/24/2023

Функция 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) пользователя в виде имени входа в интернет-стиле (например, "someone@example.com"). Если этот параметр имеет значение NULL, используется контекст вызывающего объекта.

[in] lpPassword

Если параметр lpAccount указывает имя учетной записи, этот параметр должен указывать на пароль, используемый при подключении к контроллеру домена. В противном случае этот параметр должен иметь значение NULL.

[out] OUCount

Получает количество подразделений, возвращенных в списке объединяемых подразделений.

[out] OUs

Указатель на массив, получающий список объединяемых подразделений. Этот массив выделяется системой и должен быть освобожден с помощью одного вызова функции NetApiBufferFree . Дополнительные сведения см. в разделах Буферы функций управления сетью и Длина буфера функции управления сетью.

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

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

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

Код возврата	Описание
ERROR_NOT_ENOUGH_MEMORY	Недостаточно места для обработки этой команды.
NERR_DefaultJoinRequired	Конечный контроллер домена не поддерживает создание учетных записей компьютеров в подразделениях.

Требования


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

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

NetGetJoinInformation

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

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

Share via