IReplicaMetadata::ReportLiveItemByIndexedFields
Signale que l'élément identifié par la valeur de champ indexé est actif et ne doit pas être considéré comme étant supprimé.
HRESULT ReportLiveItemByIndexedFields(
LPCWSTR * ppcszCustomFieldNames,
IFieldValue ** ppFieldValues,
BYTE cCustomFields);
Paramètres
- ppcszCustomFieldNames
[in, size_is(cCustomFields)] Ensemble de noms de champ indexé qui définissent les éléments à signaler comme actifs.
- ppFieldValues
[in, size_is(cCustomFields)] Ensemble de valeurs de champ indexé qui définissent les éléments à signaler comme actifs. 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.
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.
SYNC_E_METADATA_ITEM_NOT_FOUND si aucun élément correspondant n'est trouvé dans le magasin des métadonnées.
Notes
Cette méthode fait partie du service de détection de suppressions. Un élément est marqué comme étant actif dans le magasin des métadonnées lorsque IReplicaMetadata::SaveItemMetadata a été appelée pour un élément modifié, ou lorsque IReplicaMetadata::ReportLiveItemByIndexedFields ou IReplicaMetadata::ReportLiveItemByGlobalId a été appelée pour un élément inchangé, mais toujours actif. Un fournisseur peut appeler IReplicaMetadata::GetUnreportedItems ou IReplicaMetadata::GetUnreportedItemsByIndexedFields pour obtenir des éléments qui existent dans le magasin des métadonnées et qui ne sont pas signalés comme actifs. Le fournisseur peut alors marquer ces éléments comme supprimés dans le magasin des métadonnées.