DsReplicaGetInfoW 함수(ntdsapi.h)
DsReplicaGetInfo 함수는 디렉터리 서비스에서 복제 상태 데이터를 검색합니다.
구문
NTDSAPI DWORD DsReplicaGetInfoW(
[in] HANDLE hDS,
[in] DS_REPL_INFO_TYPE InfoType,
[in, optional] LPCWSTR pszObject,
[in, optional] UUID *puuidForSourceDsaObjGuid,
[out] VOID **ppInfo
);
매개 변수
[in] hDS
DSBind 또는 DSBindWithCred 함수에서 가져온 디렉터리 서비스 핸들을 포함합니다.
[in] InfoType
검색할 복제 데이터의 형식을 지정하는 DS_REPL_INFO_TYPE 값 중 하나를 포함합니다. 이 값은 ppInfo에서 반환되는 구조체의 형식도 결정합니다.
이 함수에는 다음 값만 지원됩니다. 다른 데이터 형식이 필요한 경우 DsReplicaGetInfo2 함수를 사용해야 합니다.
DS_REPL_INFO_NEIGHBORS
DS_REPL_INFO_CURSORS_FOR_NC
DS_REPL_INFO_METADATA_FOR_OBJ
DS_REPL_INFO_KCC_DSA_CONNECT_FAILURES
DS_REPL_INFO_KCC_DSA_LINK_FAILURES
DS_REPL_INFO_PENDING_OPS
[in, optional] pszObject
복제 데이터를 검색할 개체를 식별하는 null로 끝나는 상수 유니코드 문자열에 대한 포인터입니다. 이 매개 변수의 의미는 InfoType 매개 변수의 값에 따라 달라집니다. 가능한 값 코드는 다음과 같습니다.
DS_REPL_INFO_NEIGHBORS
pszObject 는 복제 인접 항목이 요청되는 명명 컨텍스트를 식별합니다.
DS_REPL_INFO_CURSORS_FOR_NC
pszObject 는 복제 커서가 요청되는 명명 컨텍스트를 식별합니다.
DS_REPL_INFO_METADATA_FOR_OBJ
pszObject 는 복제 메타데이터가 요청되는 개체를 식별합니다.
DS_REPL_INFO_KCC_DSA_CONNECT_FAILURES
pszObject 는 NULL이어야 합니다.
DS_REPL_INFO_KCC_DSA_LINK_FAILURES
pszObject 는 NULL이어야 합니다.
DS_REPL_INFO_PENDING_OPS
pszObject 는 NULL이어야 합니다.
[in, optional] puuidForSourceDsaObjGuid
특정 복제 원본을 식별하는 GUID 값에 대한 포인터입니다. 이 매개 변수가 NULL 이 아니고 InfoType 매개 변수에 DS_REPL_INFO_NEIGHBORS 포함된 경우 디렉터리에 지정된 objectGuid 가 있는 nTDSDSA 개체에 해당하는 원본에 대한 인접 데이터만 반환됩니다. NULL이거나 InfoType 매개 변수가 DS_REPL_INFO_NEIGHBORS 이외의 매개 변수인 경우 이 매개 변수는 무시됩니다.
[out] ppInfo
요청된 데이터를 수신하는 구조체 포인터의 주소입니다. InfoType 매개 변수의 값은 이 구조체의 형식을 결정합니다. 자세한 내용과 가능한 InfoType 값 및 해당 구조체 형식 목록은 DS_REPL_INFO_TYPE 참조하세요.
호출자는 DsReplicaFreeInfo를 호출하여 더 이상 필요하지 않은 경우 이 메모리를 해제해야 합니다.
반환 값
성공하면 ERROR_SUCCESS 반환하고, 그렇지 않으면 Win32 또는 RPC 오류를 반환합니다. 가능한 오류 코드는 다음과 같습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | ntdsapi.h |
| 라이브러리 | Ntdsapi.lib |
| DLL | Ntdsapi.dll |