共用方式為

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。

如果函式失敗，傳回值可以是下列其中一個錯誤碼或其中一個 系統錯誤碼。

傳回碼 描述
ERROR_NOT_ENOUGH_MEMORY
 沒有足夠的儲存體可用來處理此命令。
NERR_DefaultJoinRequired
 目的地網域控制站不支援在 OU 中建立電腦帳戶。

備註

成功執行 NetGetJoinableOUs 函式不需要特殊群組成員資格。

如需組織單位的詳細資訊，請參閱 Active Directory 檔中 的管理使用者 。

需求

   
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 lmjoin.h (包含 Lm.h)
程式庫 Netapi32.lib
Dll Netapi32.dll

另請參閱

NetGetJoinInformation

網路管理功能

網路管理概觀