Compartir a través de


Propiedad canónica PidTagInstanceKey

Hace referencia a: Outlook 2013 | Outlook 2016

Contiene un valor que identifica de forma única una fila de una tabla.

Propiedad Valor
Propiedades asociadas:
PR_INSTANCE_KEY
Identificador:
0x0FF6
Tipo de datos:
PT_BINARY
Área:
Tabla

Comentarios

Esta propiedad es un valor binario que identifica de forma única una fila en una vista de tabla. Es una columna necesaria en la mayoría de las tablas. Si se incluye una fila en dos vistas, hay dos claves de instancia diferentes. La clave de instancia de una fila puede diferir cada vez que se abre la tabla, pero permanece constante mientras la tabla está abierta. Las filas agregadas mientras se usa una tabla no reutilizan una clave de instancia que se usó anteriormente.

Use las propiedades PR_ENTRYID (PidTagEntryId) o PR_RECORD_KEY (PidTagRecordKey) para correlacionar todas las filas de una expansión. Use PR_INSTANCE_KEY para buscar una instancia determinada dentro de la expansión.

Cuando una propiedad multivalor se expande en una tabla, se crea una fila para cada instancia de la expansión, es decir, para cada valor de esa propiedad. Cada fila tiene un valor único para la propiedad PR_INSTANCE_KEY , mientras que todas las demás columnas conservan sus valores originales durante toda la expansión.

En un tipo clasificado de una tabla, las filas que no corresponden a datos reales se pueden agregar al resultado de la ordenación. Cada fila, como todas las filas de todas las tablas, tiene su propia clave de instancia única.

PR_INSTANCE_KEY también se usa en las notificaciones de eventos de tabla. Los miembros propIndex y propPrior de la estructura TABLE_NOTIFICATION son estructuras SPropValue que contienen valores PR_INSTANCE_KEY . El miembro propIndex indica la fila que se agregó o cambió. El miembro propPrior indica la fila anterior a la fila agregada o modificada (PR_NULL indica un cambio en la primera fila).

Este valor no se copia como parte de la tabla para mostrar.

PR_INSTANCE_KEY es una estructura MAPIUID . Todas las claves de instancia se pueden comparar directamente como valores binarios.

Especificaciones del protocolo

[MS-OXPROPS]

Proporciona referencias a las especificaciones de protocolo de Exchange Server relacionadas.

[MS-OXOABK]

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.

Vea también

Propiedades MAPI

Propiedades canónicas mapi

Asignación de nombres de propiedad canónicos a nombres MAPI

Asignación de nombres MAPI a nombres de propiedad canónicos