DsRoleGetPrimaryDomainInformation 함수(dsrole.h)

DsRoleGetPrimaryDomainInformation 함수는 컴퓨터의 상태 데이터를 검색합니다. 이 데이터에는 디렉터리 서비스 설치 및 도메인 데이터의 상태가 포함됩니다.

구문

DWORD DsRoleGetPrimaryDomainInformation(
  [in]  LPCWSTR                          lpServer,
  [in]  DSROLE_PRIMARY_DOMAIN_INFO_LEVEL InfoLevel,
  [out] PBYTE                            *Buffer
);

매개 변수

[in] lpServer

함수를 호출할 컴퓨터의 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 로컬 컴퓨터가 사용됩니다.

[in] InfoLevel

검색할 데이터 형식을 지정하는 DSROLE_PRIMARY_DOMAIN_INFO_LEVEL 값 중 하나를 포함합니다. 이 매개 변수는 버퍼에 제공된 데이터의 형식도 결정합니다.

[out] Buffer

요청된 데이터를 수신하는 버퍼의 주소에 대한 포인터입니다. 이 데이터의 형식은 InfoLevel 매개 변수의 값에 따라 달라집니다.

호출자는 DsRoleFreeMemory를 호출하여 더 이상 필요하지 않은 경우 이 메모리를 해제해야 합니다.

반환 값

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

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

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista
지원되는 최소 서버 Windows Server 2008
대상 플랫폼 Windows
헤더 dsrole.h
라이브러리 Netapi32.lib
DLL Netapi32.dll

추가 정보

DSROLE_OPERATION_STATE_INFO

DSROLE_PRIMARY_DOMAIN_INFO_BASIC

DSROLE_UPGRADE_STATUS_INFO

디렉터리 서비스 함수

DsRoleFreeMemory