IReplicaMetadata::FindItemMetadataByIndexedFields
Devuelve una lista de entradas de metadatos de elementos que tienen el valor especificado para el campo indizado.
Sintaxis
HRESULT FindItemMetadataByIndexedFields(
LPCWSTR * ppcszCustomFieldNames,
IFieldValue ** ppFieldValues,
BYTE cCustomFields,
IItemMetadataEnumerator ** ppItemMetadataEnumerator);
Parámetros
ppcszCustomFieldNames
[in, size_is(cCustomFields)] Conjunto de nombres de campo indizados que definen los elementos que hay que buscar.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.ppItemMetadataEnumerator
[out] Devuelve la lista de entradas de metadatos de elementos que tienen los valores especificados para los campos indizados.
Valor devuelto
S_OK
E_POINTER
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
Si no existen elementos con los valores especificados para los campos indizados, se devuelve un enumerador vacío.
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.