DsReplicaGetInfo2W 함수(ntdsapi.h)
DsReplicaGetInfo2 함수는 디렉터리 서비스에서 복제 상태 데이터를 검색합니다. 이 함수를 사용하면 검색할 항목이 1000개 이상인 경우 결과의 페이징을 허용합니다.
구문
NTDSAPI DWORD DsReplicaGetInfo2W(
[in] HANDLE hDS,
[in] DS_REPL_INFO_TYPE InfoType,
[in, optional] LPCWSTR pszObject,
[in, optional] UUID *puuidForSourceDsaObjGuid,
[in, optional] LPCWSTR pszAttributeName,
[in, optional] LPCWSTR pszValue,
[in] DWORD dwFlags,
[in] DWORD dwEnumerationContext,
[out] VOID **ppInfo
);
매개 변수
[in] hDS
DSBind 또는 DSBindWithCred 함수에서 가져온 디렉터리 서비스 핸들을 포함합니다.
[in] InfoType
검색할 복제 데이터의 형식을 지정하는 DS_REPL_INFO_TYPE 값 중 하나를 포함합니다. 또한 이 값은 ppInfo에서 반환되는 구조체 유형을 결정합니다.
[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이어야 합니다.
DS_REPL_INFO_METADATA_FOR_ATTR_VALUE
pszObject 는 특성 복제 메타데이터가 요청되는 개체를 식별합니다.
DS_REPL_INFO_CURSORS_2_FOR_NC
DS_REPL_INFO_CURSORS_3_FOR_NC
DS_REPL_INFO_METADATA_2_FOR_OBJ
pszObject 는 복제 메타데이터가 요청되는 개체를 식별합니다.
DS_REPL_INFO_METADATA_2_FOR_ATTR_VALUE
pszObject 는 특성 복제 메타데이터가 요청되는 개체를 식별합니다.
[in, optional] puuidForSourceDsaObjGuid
특정 복제 원본을 식별하는 GUID 값에 대한 포인터입니다. 이 매개 변수가 NULL 이 아니고 InfoType 매개 변수에 DS_REPL_INFO_NEIGHBORS 포함된 경우 디렉터리에 지정된 objectGuid 가 있는 nTDSDSA 개체에 해당하는 원본에 대한 인접 데이터만 반환됩니다. NULL이거나 InfoType 매개 변수가 DS_REPL_INFO_NEIGHBORS 이외의 매개 변수인 경우 이 매개 변수는 무시됩니다.
[in, optional] pszAttributeName
복제 데이터를 검색할 특정 특성의 이름을 포함하는 null로 종료된 유니코드 문자열에 대한 포인터입니다.
이 매개 변수는 InfoType 매개 변수에 다음 값 중 하나가 포함된 경우에만 사용됩니다.
DS_REPL_INFO_METADATA_FOR_ATTR_VALUE
DS_REPL_INFO_METADATA_2_FOR_ATTR_VALUE
[in, optional] pszValue
일치시킬 고유 이름 값을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 요청된 특성이 고유 이름 형식 값인 경우 이 함수는 지정된 값을 포함하는 특성을 반환합니다.
[in] dwFlags
함수의 동작을 수정하는 플래그 집합을 포함합니다. 이 매개 변수는 0 또는 다음 값일 수 있습니다.
DS_REPL_INFO_FLAG_IMPROVE_LINKED_ATTRS
특성 메타데이터가 특성의 연결된 값에 대한 메타데이터를 고려하도록 합니다. 결과 벡터는 모든 특성의 변경 내용을 나타냅니다. 이 수정된 벡터는 모든 특성 및 메타데이터가 특성 메타데이터 벡터에 포함될 것으로 예상하는 클라이언트에 유용합니다.
[in] dwEnumerationContext
검색할 다음 항목의 인덱스를 포함합니다. 이 함수를 처음 호출할 때는 이 매개 변수를 0으로 설정해야 합니다.
이 매개 변수는 InfoType 매개 변수에 다음 값 중 하나가 포함된 경우에만 사용됩니다.
DS_REPL_INFO_CURSORS_2_FOR_NC
DS_REPL_INFO_CURSORS_3_FOR_NC
DS_REPL_INFO_METADATA_FOR_ATTR_VALUE
DS_REPL_INFO_METADATA_2_FOR_ATTR_VALUE
이 함수는 각 호출에서 최대 1,000개의 항목을 검색합니다. 이 함수를 호출한 후 더 많은 항목을 사용할 수 있는 경우 검색된 구조체의 dwEnumerationContext 멤버에 검색할 다음 항목의 인덱스가 포함됩니다. 검색된 구조체의 dwEnumerationContext 멤버는 이 함수에 대한 다음 호출에서 dwEnumerationContext 매개 변수로 사용됩니다. 모든 항목을 검색하면 검색된 구조체의 dwEnumerationContext 멤버에 -1이 포함됩니다. 이 매개 변수에 대해 -1이 전달되면 이 함수는 ERROR_NO_MORE_ITEMS 반환합니다.
[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 |