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