IReplicaMetadata::FindItemMetadataByUniqueIndexedFields
Returns the unique item metadata entry that has the specified value for the indexed field.
S_OK
S_FALSE if no matching item is found.
E_POINTER
SYNC_E_METADATA_QUERY_REQUIRES_UNIQUE_INDEXED_FIELDS if a field in ppcszCustomFieldNames was not specified as a unique index field when the metadata was initialized.
SYNC_E_METADATA_QUERY_REQUIRES_INDEXED_FIELDS if a field in ppcszCustomFieldNames was not specified as an index field when the metadata was initialized.
SYNC_E_METADATA_FIELD_INVALID_NAME if a field name in ppcszCustomFieldNames does not exist.
SYNC_E_METADATA_FIELD_INVALID_TYPE if a field value in ppFieldValues does not match the type of the corresponding field.
Custom fields must be established when the replica metadata is first initialized by passing a list of CUSTOM_FIELD_DEFINITION structures to ISyncMetadataStore::InitializeReplicaMetadata.
Index fields must be established and marked as unique when the replica metadata is first initialized by passing a list of CUSTOM_FIELDS_INDEX structures to ISyncMetadataStore::InitializeReplicaMetadata.