IReplicaMetadata::FindItemMetadataByUniqueIndexedFields
Devuelve la entrada de metadatos de elementos única que tiene el valor especificado para el campo indizado.
HRESULT FindItemMetadataByUniqueIndexedFields(
LPCWSTR * ppcszCustomFieldNames,
IFieldValue ** ppFieldValues,
BYTE cCustomFields,
IItemMetadata ** ppItemMetadata);
Parámetros
- ppcszCustomFieldNames
[in, size_is(cCustomFields)] Conjunto de nombres de campo indizados que definen los elementos que hay que buscar. Estos nombres de campo deben estar en el mismo orden que el usado para especificar el índice cuando se llamó a ISyncMetadataStore::InitializeReplicaMetadata.
- ppFieldValues
[in, size_is(cCustomFields)] Conjunto de valores especificados para los campos indizados que definen los elementos que hay que buscar. Estos valores deben estar en el mismo orden que los nombres de ppcszCustomFieldNames.
- cCustomFields
[in] Número de entradas de ppcszCustomFieldNames y de ppFieldValues.
- ppItemMetadata
[out] Devuelve la entrada de metadatos de elementos única que tiene el valor especificado para el campo indizado.
Valor devuelto
S_OK
S_FALSE si no se encuentra ningún elemento coincidente.
E_POINTER
SYNC_E_METADATA_QUERY_REQUIRES_UNIQUE_INDEXED_FIELDS si un campo de ppcszCustomFieldNames no se especificó como un campo indizado único al inicializar los metadatos.
SYNC_E_METADATA_QUERY_REQUIRES_INDEXED_FIELDS si un campo de ppcszCustomFieldNames no se especificó como un campo indizado al inicializar los metadatos.
SYNC_E_METADATA_FIELD_INVALID_NAME si no existe un nombre de campo en ppcszCustomFieldNames.
SYNC_E_METADATA_FIELD_INVALID_TYPE si el valor de un campo de ppFieldValues no coincide con el tipo del campo correspondiente.
Notas
Los campos personalizados se deben establecer cuando se inicializan los metadatos de la réplica pasando una lista de estructuras CUSTOM_FIELD_DEFINITION a ISyncMetadataStore::InitializeReplicaMetadata.
Los campos indizados se deben establecer y marcar como únicos cuando se inicializan los metadatos de la réplica por primera vez pasando una lista de estructuras CUSTOM_FIELDS_INDEX a ISyncMetadataStore::InitializeReplicaMetadata.