NetGetJoinInformation 함수(lmjoin.h)

  • 아티클

NetGetJoinInformation 함수는 지정된 컴퓨터에 대한 조인 상태 정보를 검색합니다.

구문

NET_API_STATUS NET_API_FUNCTION NetGetJoinInformation(
  [in]  LPCWSTR               lpServer,
  [out] LPWSTR                *lpNameBuffer,
  [out] PNETSETUP_JOIN_STATUS BufferType
);

매개 변수

[in] lpServer

함수를 호출할 컴퓨터의 DNS 또는 NetBIOS 이름을 지정하는 상수 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 로컬 컴퓨터가 사용됩니다.

[out] lpNameBuffer

컴퓨터가 조인된 도메인 또는 작업 그룹의 NetBIOS 이름을 받는 버퍼에 대한 포인터입니다. 이 버퍼는 시스템에서 할당되며 NetApiBufferFree 함수를 사용하여 해제해야 합니다. 자세한 내용은 네트워크 관리 함수 버퍼 및 네트워크관리 함수 버퍼 길이를 참조하세요.

[out] BufferType

지정된 컴퓨터의 조인 상태 받습니다. 이 매개 변수는 다음 값 중 하나를 가질 수 있습니다.

typedef enum _NETSETUP_JOIN_STATUS {

    NetSetupUnknownStatus = 0,
    NetSetupUnjoined,
    NetSetupWorkgroupName,
    NetSetupDomainName

} NETSETUP_JOIN_STATUS, *PNETSETUP_JOIN_STATUS;

이러한 값에는 다음과 같은 의미가 있습니다.

값 의미
NetSetupUnknownStatus
 상태 알 수 없습니다.
NetSetupUnjoined
 컴퓨터가 조인되지 않았습니다.
NetSetupWorkgroupName
 컴퓨터가 작업 그룹에 조인됩니다.
NetSetupDomainName
 컴퓨터가 도메인에 가입되어 있습니다.

반환 값

함수가 성공하면 반환 값이 NERR_Success.

함수가 실패하면 반환 값은 다음 오류 코드 또는 시스템 오류 코드 중 하나일 수 있습니다.

반환 코드 설명
ERROR_NOT_ENOUGH_MEMORY
 이 명령을 처리하는 데 스토리지가 부족합니다.

설명

NetGetJoinInformation 함수를 성공적으로 실행하려면 특별한 그룹 멤버 자격이 필요하지 않습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 lmjoin.h(Lm.h 포함)
라이브러리 Netapi32.lib
DLL Netapi32.dll; Wkscli.dll

참고 항목

NetGetJoinableOU

네트워크 관리 함수

네트워크 관리 개요