Propiedad canónica PidTagRecordKey
Hace referencia a: Outlook 2013 | Outlook 2016
Contiene un identificador único comparable binario para un objeto específico.
| Propiedad | Valor |
|---|---|
| Propiedades asociadas: |
PR_RECORD_KEY |
| Identificador: |
0x0FF9 |
| Tipo de datos: |
PT_BINARY |
| Área: |
Propiedades del identificador |
Comentarios
Esta propiedad facilita la búsqueda de referencias a un objeto, como buscar su fila en una tabla de contenido. Esta propiedad no se puede usar para abrir un objeto; use el identificador de entrada para ese propósito.
Esta propiedad debe identificar un subobjeto de datos adjuntos de forma única dentro de un mensaje. Este identificador es la única característica de datos adjuntos que se garantiza que permanece igual después de cerrar y volver a abrir el mensaje. El proveedor de almacén debe conservar esta propiedad entre sesiones para garantizar esta garantía.
En el caso de las carpetas, esta propiedad contiene una clave usada en la tabla de jerarquía de carpetas. Normalmente, este es el mismo valor que el proporcionado por la propiedad PR_ENTRYID (PidTagEntryId).
En el caso de los almacenes de mensajes, esta propiedad es idéntica a la propiedad PR_STORE_RECORD_KEY (PidTagStoreRecordKey).
En un objeto de almacén de mensajes, esta propiedad debe ser única en todos los proveedores de almacén. Una manera de hacerlo es combinar el valor de la propiedad PR_MDB_PROVIDER (PidTagStoreProvider) para el almacén (único para ese tipo de proveedor) con una estructura GUID u otro valor único para el almacén de mensajes específico.
Esta propiedad siempre está disponible a través del método IMAPIProp::GetProps después de la primera llamada al método IMAPIProp::SaveChanges . Algunos proveedores pueden hacer que esté disponible inmediatamente después de la creación de instancias.
Un cliente o proveedor de servicios puede comparar valores de esta propiedad mediante memcmp. Esto no es posible para los valores de identificador de entrada. Sin embargo, se garantiza que esta propiedad es única dentro del mismo almacén de mensajes o contenedor de libreta de direcciones; dos objetos de contenedores diferentes pueden tener el mismo valor de esta propiedad.
Una distinción entre el registro y las claves de búsqueda es que la clave de registro es específica del objeto, mientras que la clave de búsqueda se puede copiar en otros objetos. Por ejemplo, dos copias del objeto pueden tener el mismo valor de PR_SEARCH_KEY (PidTagSearchKey), pero deben tener valores diferentes para esta propiedad.
En la tabla siguiente se resumen las diferencias importantes entre PR_ENTRYID, PR_SEARCH_KEY (PidTagSearchKey) 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 una llamada a SaveChanges |
Quizás |
Quizás |
Mensajes sí a otros tal vez |
| Se ha cambiado en una operación de copia |
Sí |
Sí |
No |
| Modificable por un 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í |
Recursos relacionados
Especificaciones del protocolo
Proporciona referencias a las especificaciones de protocolo de Exchange Server relacionadas.
Controla los objetos de mensajes y datos adjuntos.
Especifica las propiedades y operaciones de las listas de usuarios, contactos, grupos y recursos.
Archivos de encabezado
Mapidefs.h
Proporciona definiciones de tipo de datos.
Mapitags.h
Contiene definiciones de propiedades enumeradas como nombres alternativos.