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。
如果函数失败,则返回值可以是以下错误代码之一或 系统错误代码之一。
返回代码 | 说明 |
---|---|
|
没有足够的存储空间可用于处理此命令。 |
|
目标域控制器不支持在 OU 中创建计算机帐户。 |
注解
无需特殊组成员身份即可成功执行 NetGetJoinableOUs 函数。
有关组织单位的详细信息,请参阅 Active Directory 文档中的管理 用户 。
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | lmjoin.h (包括 Lm.h) |
Library | Netapi32.lib |
DLL | Netapi32.dll |