NetGetAnyDCName 함수(lmaccess.h)

NetGetAnyDCName 함수는 지정된 서버에서 직접 신뢰하는 도메인의 DC(도메인 컨트롤러)의 이름을 반환합니다.

DNS 스타일 이름을 지원하는 애플리케이션은 DsGetDcName 함수를 호출해야 합니다. 이 함수는 지정된 서버에서 도메인을 직접 신뢰하는지 여부에 관계없이 모든 도메인에서 DC를 찾을 수 있습니다.

구문

NET_API_STATUS NET_API_FUNCTION NetGetAnyDCName(
        LPCWSTR ServerName,
        LPCWSTR DomainName,
        LPBYTE  *Buffer
);

ServerName

함수를 실행할 원격 서버의 DNS 또는 NetBIOS 이름을 지정하는 상수 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 로컬 컴퓨터가 사용됩니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

DomainName

도메인의 이름을 지정하는 상수 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 주 도메인에 대한 도메인 컨트롤러의 이름이 사용됩니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

Buffer

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

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

반환 코드	설명
ERROR_NO_LOGON_SERVERS	도메인 컨트롤러를 찾을 수 없습니다.
ERROR_NO_SUCH_DOMAIN	지정된 도메인이 신뢰할 수 있는 도메인이 아닙니다.
ERROR_NO_TRUST_LSA_SECRET	트러스트 관계의 클라이언트 쪽이 끊어졌습니다.
ERROR_NO_TRUST_SAM_ACCOUNT	트러스트 관계의 서버 쪽이 끊어지거나 암호가 손상되었습니다.
ERROR_DOMAIN_TRUST_INCONSISTENT	응답한 서버가 지정된 도메인의 적절한 도메인 컨트롤러가 아닙니다.

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

servername이 독립 실행형 워크스테이션 또는 독립 실행형 서버를 지정하는 경우 도메인 이름이 유효하지 않습니다.

servername이 도메인의 구성원인 워크스테이션 또는 도메인의 구성원인 서버를 지정하는 경우 도메인 이름은servername과 동일한 도메인에 있어야 합니다.

servername에서 도메인 컨트롤러를 지정하는 경우 도메인 이름은 서버가 컨트롤러인 도메인에서 신뢰할 수 있는 도메인 중 하나여야 합니다. 이 호출에서 찾은 도메인 컨트롤러는 이 호출 중에 한 번 이상 작동했습니다.

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