IReplicaMetadata::GetUnreportedItemsByIndexedFields
지정된 인덱싱된 필드 값 집합이 설정된 항목 중 메타데이터 저장소에서 현재 활성 상태로 표시되어 있지 않고 이미 삭제된 것으로 표시되지 않은 항목의 목록을 반환합니다.
HRESULT GetUnreportedItemsByFieldValue (
LPCWSTR * ppcszCustomFieldNames,
IFieldValue ** ppFieldValues,
BYTE cCustomFields,
IItemMetadataEnumerator ** ppItemMetadataEnumerator);
매개 변수
- ppcszCustomFieldNames
[in, size_is(cCustomFields)] 검색할 항목을 정의하는 인덱싱된 필드 이름 집합입니다.
- ppFieldValues
[in, size_is(cCustomFields)] 검색할 항목을 정의하는 인덱싱된 필드 값 집합입니다. 이 값은 ppcszCustomFieldNames의 이름과 순서가 같아야 합니다.
- cCustomFields
[in] ppcszCustomFieldNames 및 ppFieldValues의 항목 수입니다.
- ppItemMetadataEnumerator
[out] 지정된 인덱싱된 필드 값 집합이 설정된 항목 중 메타데이터 저장소에서 현재 활성 상태로 표시되어 있지 않고 이미 삭제된 것으로 표시되지 않은 항목의 목록을 반환합니다.
반환 값
S_OK
E_POINTER
E_OUTOFMEMORY
메타데이터가 초기화될 때 ppcszCustomFieldNames의 필드가 인덱스 필드로 지정되지 않은 경우 SYNC_E_METADATA_QUERY_REQUIRES_INDEXED_FIELDS입니다.
ppcszCustomFieldNames의 필드 이름이 없으면 SYNC_E_METADATA_FIELD_INVALID_NAME입니다.
ppFieldValues의 필드 값이 해당 필드의 형식과 일치하지 않으면 SYNC_E_METADATA_FIELD_INVALID_TYPE입니다.
주의
지정된 인덱싱된 필드 값을 가지고 있는 비활성 항목이 없으면 빈 열거자가 반환됩니다.
이 메서드는 삭제 검색 서비스의 일부입니다. 변경된 항목에 대해 IReplicaMetadata::SaveItemMetadata를 호출할 경우나, 변경되지 않았지만 여전히 활성 상태에 있는 항목에 대해 IReplicaMetadata::ReportLiveItemByIndexedFields 또는 IReplicaMetadata::ReportLiveItemByGlobalId를 호출할 경우 항목은 메타데이터 저장소에서 활성 상태로 표시됩니다. 공급자는 IReplicaMetadata::GetUnreportedItems 또는 IReplicaMetadata::GetUnreportedItemsByIndexedFields를 호출하여 메타데이터 저장소에 있는 항목 중 활성 상태로 보고되지 않은 항목을 가져올 수 있습니다. 그런 다음 공급자는 메타데이터 저장소에서 이러한 항목을 삭제된 것으로 표시할 수 있습니다.