NetGetJoinableOUs 函数 (lmjoin.h)

NetGetJoinableOUs 函数检索组织单位的列表, (OU) 可在其中创建计算机帐户。

语法

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
);

parameters

[in] lpServer

指向常量字符串的指针,该常量字符串指定要调用函数的计算机的 DNS 或 NetBIOS 名称。 如果此参数为 NULL,则使用本地计算机。

[in] lpDomain

指向常量字符串的指针,该常量字符串指定要为其检索可联接的 OU 列表的域的名称。

[in] lpAccount

指向常量字符串的指针,该常量字符串指定在连接到域控制器时要使用的帐户名。 该字符串必须指定域 NetBIOS 名称和用户帐户 (例如,“REDMOND\user”) 或用户主体名称 (UPN) ,其格式为 Internet 样式的登录名 (例如“”someone@example.com) 。 如果此参数为 NULL,则使用调用方上下文。

[in] lpPassword

如果 lpAccount 参数指定帐户名称,则此参数必须指向连接到域控制器时要使用的密码。 否则,此参数必须为 NULL

[out] OUCount

接收可联接 OU 列表中返回的 OU 计数。

[out] OUs

指向接收可联接 OU 列表的数组的指针。 此数组由系统分配,必须使用对 NetApiBufferFree 函数的单个调用来释放。 有关详细信息,请参阅 网络管理功能缓冲区网络管理功能缓冲区长度

返回值

如果函数成功,则返回值NERR_Success。

如果函数失败,则返回值可以是以下错误代码之一或 系统错误代码之一。

返回代码 说明
ERROR_NOT_ENOUGH_MEMORY
没有足够的存储空间可用于处理此命令。
NERR_DefaultJoinRequired
目标域控制器不支持在 OU 中创建计算机帐户。

注解

无需特殊组成员身份即可成功执行 NetGetJoinableOUs 函数。

有关组织单位的详细信息,请参阅 Active Directory 文档中的管理 用户

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 lmjoin.h (包括 Lm.h)
Library Netapi32.lib
DLL Netapi32.dll

另请参阅

NetGetJoinInformation

网络管理功能

网络管理概述