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
);
參數
[in] lpServer
常數位符串的指標,指定要呼叫函式之電腦的 DNS 或 NetBIOS 名稱。 如果此參數為 Null,則會使用本機電腦。
[in] lpDomain
常數位符串的指標,指定要擷取可聯結之 OU 清單的功能變數名稱。
[in] lpAccount
常數位符串的指標,指定連接到網域控制站時要使用的帳戶名稱。 字串必須指定網域 NetBIOS 名稱和使用者帳戶 (,例如「REDMOND\user」) 或使用者主體名稱 (UPN) 的使用者主體名稱,格式為網際網路樣式登入名稱 (例如 「 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) |
程式庫 | Netapi32.lib |
Dll | Netapi32.dll |