Propiedad canónica PidTagSearchKey

Artículo
04/04/2023

Hace referencia a: Outlook 2013 | Outlook 2016

Contiene una clave comparable binaria que identifica objetos correlacionados para una búsqueda.

Propiedad	Valor
Propiedades asociadas:	PR_SEARCH_KEY
Identificador:	0x300B
Tipo de datos:	PT_BINARY
Área:	Propiedades del identificador

Comentarios

Esta propiedad proporciona un seguimiento para objetos relacionados, como copias de mensajes, y facilita la búsqueda de repeticiones no deseadas, como destinatarios duplicados.

MAPI usa reglas específicas para construir claves de búsqueda para destinatarios de mensajes. La clave de búsqueda se forma concatenando el tipo de dirección (en caracteres en mayúsculas), el carácter de dos puntos ':', la dirección de correo electrónico en forma canónica y el carácter nulo de terminación. La forma canónica aquí significa que las direcciones que distinguen mayúsculas de minúsculas aparecen en el caso correcto y las direcciones que no distinguen mayúsculas de minúsculas se convierten en mayúsculas. Esto es importante para conservar las correlaciones entre los mensajes.

Para los objetos de mensaje, esta propiedad está disponible a través del método IMAPIProp::GetProps inmediatamente después de la creación del mensaje. Para otros objetos, está disponible después de la primera llamada al método IMAPIProp::SaveChanges . Dado que esta propiedad es modificable, no es confiable obtenerla a través de GetProps hasta que una llamada a SaveChanges haya confirmado los valores establecidos o modificados por el método IMAPIProp::SetProps .

Para los perfiles, MAPI también proporciona una sección de perfil codificado de forma rígida denominada MUID_PROFILE_INSTANCE, con esta propiedad como propiedad única. Se garantiza que esta clave es única entre todos los perfiles creados y puede ser más confiable que la propiedad PR_PROFILE_NAME (PidTagProfileName), que puede eliminarse y volver a crearse con el mismo nombre, por ejemplo.

En la tabla siguiente se resumen las diferencias importantes entre los PR_ENTRYID (PidTagEntryId), PR_RECORD_KEY (PidTagRecordKey) y esta propiedad.

Característica	PR_ENTRYID	PR_RECORD_KEY	PR_SEARCH_KEY
Obligatorio en los objetos de datos adjuntos	No	Sí	No
Obligatorio en objetos de carpeta	Sí	Sí	No
Obligatorio en los objetos del almacén de mensajes	Sí	Sí	No
Obligatorio en objetos de estado	Sí	No	No
Creatable por cliente	No	No	Sí
Disponible antes de SaveChanges	Depende de la implementación del proveedor	Depende de la implementación del proveedor	Para los mensajes, sí. Para otros, depende de la implementación del proveedor.
Se ha cambiado en una operación de copia	Sí	Sí	No
Modificable por el cliente después de una copia	No	No	Sí
Único dentro de ...	Todo el mundo	Instancia del proveedor	Todo el mundo
Binario comparable (como con memcmp)	No: use IMAPISupport::CompareEntryIDs	Sí	Sí