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 関数の 1 回の呼び出しを使用して解放する必要があります。 詳細については、「 ネットワーク管理機能バッファー 」および「 ネットワーク管理機能バッファーの長さ」を参照してください。

戻り値

関数が成功した場合、戻り値は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

ネットワーク管理機能

ネットワーク管理の概要