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") 또는 인터넷 스타일 로그인 이름(예: "someone@example.com") 형식으로 사용자의 UPN(사용자 계정 이름)을 지정해야 합니다. 이 매개 변수가 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

참고 항목

NetGetJoinFormation

네트워크 관리 함수

네트워크 관리 개요