IKnowledgeBuilder2::AddRange
정보를 빌드하는 데 사용되는 범위 집합에 범위 및 연결된 클록 벡터를 추가합니다.
HRESULT AddRange(
BYTE* pItemId,
BYTE* pChangeUnitId,
IClockVector* piClockVector);
매개 변수
항목 |
정의 |
pItemId |
[in] 이 범위에서 항목 ID의 닫힌 하한입니다. |
pChangeUnitId |
[in, unique] 이 범위가 적용되는 변경 단위의 ID입니다. 이 값이 NULL인 경우 이 범위는 다른 조각에 다른 방식으로 지정되지 않는 모든 변경 단위에 적용됩니다. |
piClockVector |
[in] 범위에서 항목에 대해 알려진 정보를 정의하는 클록 벡터입니다. |
반환 값
S_OK
pItemId가 pChangeUnitId에 설정된 다른 모든 범위보다 크지 않으면 E_INVALIDARG입니다. 범위는 항목 ID를 기준으로 순서대로 추가해야 합니다.
E_POINTER
pItemId 또는 pChangeUnitId가 공급자의 형식 스키마에서 지정한 형식이 아니면 SYNC_E_ID_FORMAT_MISMATCH입니다.
IKnowledgeBuilder::Initialize가 호출되지 않은 경우와 같이 IKnowledgeBuilder2 개체가 잘못된 상태이면 SYNC_E_INVALID_OPERATION입니다.
빌드되는 정보의 버전이 범위와 호환되지 않으면 SYNC_E_INVALID_VERSION입니다.
주의
범위는 항목 ID를 기준으로 순서대로 추가해야 합니다. 또한 범위의 닫힌 하한을 정의하는 항목 ID는 이전 범위의 열린 상한도 정의합니다. 범위가 잘못된 순서로 추가되면 E_INVALIDARG가 반환됩니다.
Sync Framework 2.0 이상 버전의 ISyncKnowledge 개체에는 ICoreFragment 개체 집합이 포함되어 있습니다. 각 ICoreFragment 개체는 변경 단위 집합과 연결되어 있으며 범위 집합을 포함합니다. ICoreFragment 개체에 포함된 각 범위는 해당 범위의 항목에 대해 알려져 있는 내용을 정의하는 클록 벡터와 연결되어 있습니다. 일반적으로 ICoreFragment 개체 중 하나에는 변경 단위 ID가 포함되지 않습니다. 변경 단위 ID가 없는 ICoreFragment 개체에 포함되는 정보는 다른 ICoreFragment 개체에 포함되지 않는 모든 변경 단위 ID에 적용됩니다. 이 조각에 범위를 추가하려면 pChangeUnitId에 NULL을 지정합니다.