다음을 통해 공유

ICoreFragment::NextRange

  • 아티클

이 정보 조각에 포함되는 다음 범위 및 이 범위에서 항목에 대해 알려진 정보를 정의하는 클록 벡터를 반환합니다.

HRESULT NextRange(
  BYTE* pItemId,
  DWORD* pItemIdSize,
  IClockVector** piClockVector);

매개 변수

  • pItemId
    [in, out, unique, size_is(*pItemIdSize)] 이 범위에서 항목 ID의 닫힌 하한을 반환합니다. 또한 이 범위가 범위 집합의 첫 번째 범위가 아닌 경우에는 이 값이 이전 범위에서 항목 ID의 열린 상한도 됩니다.
  • pItemIdSize
    [in, out] pItemId의 바이트 수를 지정합니다. pItemId가 너무 작으면 ID를 검색하는 데 필요한 바이트 수를 반환하고, 그렇지 않으면 쓴 바이트 수를 반환합니다.
  • piClockVector
    [out] 범위에서 항목에 대해 알려진 정보를 정의하는 클록 벡터를 반환합니다.

반환 값

  • S_OK

  • 더 이상 열거할 범위가 없으면 S_FALSE입니다.

  • 항목 ID가 가변 길이 ID이고 pItemIdSize가 NULL이면 E_POINTER입니다.

  • pItemId가 너무 작으면 HRESULT_FROM_WIN32(ERROR_MORE_DATA)입니다. 이 경우에는 pItemIdSize에서 필요한 바이트 수가 반환됩니다.

  • 이 개체를 만든 후에 개체에 포함된 정보 개체가 변경되었으면 SYNC_E_INVALID_OPERATION입니다.

주의

pItemId에서 반환되는 값은 piClockVector에서 반환되는 클록 벡터와 연결된 항목 ID의 범위에서 닫힌 하한입니다. 또한 pItemId 값은 이전 범위의 열린 상한도 정의하므로 NextRange를 다시 호출하면 현재 범위의 열린 상한을 가져올 수 있습니다. 더 이상 열거할 범위가 없으면 ID가 pItemId보다 크거나 같은 모든 항목이 범위에 포함됩니다.

참고 항목

참조

ICoreFragment 인터페이스