DsIsNTDSOnline 함수

[이 함수는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. Windows Vista부터 VSS(볼륨 섀도 복사본 서비스) 를 대신 사용합니다.]

DsIsNTDSOnline 함수는 지정된 서버에서 Active Directory Domain Services 온라인 상태인지 확인합니다.

구문

HRESULT DsIsNTDSOnline(
  _In_  LPCTSTR szServerName,
  _Out_ BOOL    *pfNTDSOnline
);

szServerName [in]: 테스트할 서버의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 앞의 백슬라이시는 선택 사항입니다. 서버는 이 함수가 호출된 컴퓨터와 동일해야 합니다. 서버 이름에는 밑줄(_) 문자가 포함될 수 없습니다. 서버 이름의 예는 "\\server1"입니다.
pfNTDSOnline [out]: 결과를 수신하는 BOOL 값에 대한 포인터입니다. 디렉터리 서비스가 온라인 상태이면 TRUE 를 수신하고 디렉터리 서비스가 오프라인인 경우 FALSE 를 받습니다.

함수가 성공하면 S_OK 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 다음 목록에는 가능한 오류 코드가 나열되어 있습니다.

ERROR_ACCESS_DENIED: 호출자에게 이 함수를 호출할 수 있는 적절한 액세스 권한이 없습니다. DsSetAuthIdentity 함수를 사용하여 백업 및 복원 함수에 사용할 자격 증명을 설정할 수 있습니다.
hrCouldNotConnect: szServerName의 서버를 찾을 수 없거나, 도메인 컨트롤러가 아니거나, szServerName의 형식이 올바르게 지정되지 않았습니다. 이 값은 Ntdsbmsg.h에 정의되어 있습니다.
RPC_S_INVALID_BINDING: DsIsNTDSOnline 함수가 원격으로 호출되거나 szServerName의 서버가 도메인 컨트롤러가 아닙니다.

디렉터리 백업 또는 복원 함수를 호출하기 전에 이 함수를 호출합니다. 백업을 수행하려면 디렉터리가 온라인이어야 합니다. 복원을 수행하려면 디렉터리가 오프라인으로 있어야 합니다.

이 함수는 szServerName에 지정된 대상 서버이기도 한 도메인 컨트롤러에서만 호출할 수 있습니다. 이 함수는 원격으로 호출할 수 없습니다.

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
헤더	Ntdsbcli.h
라이브러리	Ntdsbcli.lib
DLL	Ntdsbcli.dll
유니코드 및 ANSI 이름	DsIsNTDSOnlineW (유니코드) 및 DsIsNTDSOnlineA (ANSI)