IKnowledgeSyncProvider::GetFullEnumerationChangeBatch
지정된 하한보다 ID가 큰 항목에 대한 항목 메타데이터를 포함하는 일괄 변경 내용을 전체 열거의 일부분으로 가져옵니다.
HRESULT GetFullEnumerationChangeBatch(
DWORD dwBatchSize,
const BYTE * pbLowerEnumerationBound,
ISyncKnowledge * pSyncKnowledge,
ISyncFullEnumerationChangeBatch ** ppSyncChangeBatch,
IUnknown ** ppUnkDataRetriever);
매개 변수
- dwBatchSize
[in] 일괄 변경 내용에 포함할 변경 내용 수입니다.
- pbLowerEnumerationBound
[in] 항목 ID의 하한입니다. 이 메서드는 이 ID 값보다 크거나 같은 ID가 지정된 변경 내용을 반환합니다.
- pSyncKnowledge
[in] 이 정보 개체에 항목 변경 내용이 포함된 경우에는 해당 항목의 데이터가 대상 복제본에 이미 있는 것입니다.
- ppSyncChangeBatch
[out] 지정된 하한보다 ID가 큰 항목에 대한 항목 메타데이터를 포함하는 일괄 변경 내용을 반환합니다.
- ppUnkDataRetriever
[out] 변경 내용 데이터를 검색하는 데 사용할 수 있는 개체를 반환합니다. ISynchronousDataRetriever 개체이거나 공급자 관련 개체일 수 있습니다.
반환 값
S_OK
공급자 고유의 오류 코드입니다.
주의
이 메서드는 잊어버린 정보를 복구하는 동안 Sync Framework에 의해 호출됩니다.
이 메서드는 항목 ID가 pbLowerEnumerationBound 이상인 변경 내용을 항목 ID순으로 열거합니다. 이를 통해 Sync Framework는 대상 공급자의 항목 중 삭제되었지만 원본 공급자가 잊어버린 항목을 확인할 수 있습니다. 이 메서드는 항목 ID가 pbLowerEnumerationBound보다 작고 대상 정보에 포함되지 않은 변경 내용을 항목 ID순으로 일괄 변경 내용에 선택적으로 추가할 수도 있습니다.
구현자를 위한 정보
이 일괄 처리 다음에 보낼 변경 내용이 더 없으면 반환된 일괄 변경 내용에서 ISyncChangeBatchBase::SetLastBatch를 호출해야 합니다. 그렇지 않으면 Sync Framework가 GetFullEnumerationChangeBatch를 다시 호출하여 다른 일괄 변경 내용을 검색합니다.
항목 변경 내용 메타데이터와 함께 항목 데이터를 보내는 공급자의 경우에는 pSyncKnowledge를 사용하여 항목 데이터를 보낼 필요가 있는지 여부를 확인할 수 있습니다. pSyncKnowledge에 해당 항목 변경 내용이 포함된 항목 데이터는 보낼 필요가 없습니다. 이 정보 개체를 사용하여 항목의 포함 여부를 확인하려면 현재 공급자에 포함된 정보 개체에서 ISyncKnowledge::MapRemoteToLocal 메서드를 사용하여 pSyncKnowledge를 매핑해야 합니다.