IReplicaMetadata::FindItemMetadataByUniqueIndexedFields
Retourne l'entrée de métadonnées de l'élément unique ayant la valeur spécifiée pour le champ indexé.
HRESULT FindItemMetadataByUniqueIndexedFields(
LPCWSTR * ppcszCustomFieldNames,
IFieldValue ** ppFieldValues,
BYTE cCustomFields,
IItemMetadata ** ppItemMetadata);
Paramètres
- ppcszCustomFieldNames
[in, size_is(cCustomFields)] Ensemble de noms de champ indexé qui définissent les éléments pour lesquels effectuer une recherche. Ces noms de champ doivent être dans le même ordre que celui utilisé pour spécifier l'index lorsque ISyncMetadataStore::InitializeReplicaMetadata a été appelée.
- 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.
- ppItemMetadata
[out] Retourne l'entrée de métadonnées de l'élément unique ayant la valeur spécifiée pour le champ indexé.
Valeur de retour
S_OK
S_FALSE si aucun élément correspondant n'est trouvé.
E_POINTER
SYNC_E_METADATA_QUERY_REQUIRES_UNIQUE_INDEXED_FIELDS si un champ dans ppcszCustomFieldNames n'a pas été spécifié comme champ d'index unique lorsque les métadonnées ont été initialisées.
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
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.
Les champs d'index doivent être définis et marqués comme uniques lorsque les métadonnées de réplica sont initialisées pour la première fois en passant une liste de structures CUSTOM_FIELDS_INDEX à ISyncMetadataStore::InitializeReplicaMetadata.