IReplicaMetadata::FindItemMetadataByIndexedFields
Retourne une liste d'entrées de métadonnées d'élément ayant la valeur spécifiée pour le champ indexé.
HRESULT FindItemMetadataByIndexedFields(
LPCWSTR * ppcszCustomFieldNames,
IFieldValue ** ppFieldValues,
BYTE cCustomFields,
IItemMetadataEnumerator ** ppItemMetadataEnumerator);
Paramètres
- ppcszCustomFieldNames
[in, size_is(cCustomFields)] Ensemble de noms de champ indexé qui définissent les éléments pour lesquels effectuer une recherche.
- ppFieldValues
[in, size_is(cCustomFields)] Ensemble de valeurs de champ indexé qui définissent les éléments pour lesquels effectuer une recherche. Ces valeurs doivent être dans le même ordre que les noms dans ppcszCustomFieldNames.
- cCustomFields
[in] Nombre d'entrées contenues dans ppcszCustomFieldNames et dans ppFieldValues.
- ppItemMetadataEnumerator
[out] Retourne la liste des entrées de métadonnées d'élément ayant les valeurs spécifiées pour les champs indexés.
Valeur de retour
S_OK
E_POINTER
SYNC_E_METADATA_QUERY_REQUIRES_INDEXED_FIELDS si un champ dans ppcszCustomFieldNames n'a pas été spécifié comme champ d'index lorsque les métadonnées ont été initialisées.
SYNC_E_METADATA_FIELD_INVALID_NAME si un nom de champ dans ppcszCustomFieldNames n'existe pas.
SYNC_E_METADATA_FIELD_INVALID_TYPE si une valeur de champ dans ppFieldValues ne correspond pas au type du champ correspondant.
Notes
S'il n'existe aucun élément ayant les valeurs de champ indexé spécifiées, un énumérateur vide est retourné.
Les champs personnalisés doivent être définis lorsque les métadonnées de réplica sont initialisées pour la première fois en passant une liste de structures CUSTOM_FIELD_DEFINITION à ISyncMetadataStore::InitializeReplicaMetadata.