Identificadores de entrada MAPI
Hace referencia a: Outlook 2013 | Outlook 2016
Los identificadores de entrada son fragmentos de datos binarios almacenados en una estructura ENTRYID que se usan para identificar y abrir de forma única un objeto MAPI. La mayoría de los objetos MAPI tienen identificadores de entrada. Los identificadores de entrada de los objetos son análogos a los nombres de archivo de los archivos. Sin embargo, no se pueden transmitir y no se pueden utilizar en sistemas distintos del sistema en el que se originaron.
Identificadores de entrada
Los proveedores de almacén de mensajes asignan identificadores de entrada a almacenes de mensajes, carpetas y mensajes; los proveedores de libretas de direcciones los asignan a contenedores de libreta de direcciones, listas de distribución y usuarios de mensajería. Los identificadores de entrada también se usan para abrir un objeto representado por una fila de una tabla, como un objeto de estado en la tabla de estado. Los objetos almacenan sus identificadores de entrada en su propiedad PR_ENTRYID (PidTagEntryId).
Mientras que los proveedores de servicios crean, asignan y examinan los identificadores de entrada, las aplicaciones cliente los usan solo como herramientas para abrir objetos. Para los clientes, los identificadores de entrada son fragmentos opacos de datos binarios y no tienen nada que ver con el sistema de mensajería subyacente.
Los clientes llaman al método IMAPIProp::GetProps de un objeto para recuperar su propiedad PR_ENTRYID o el método IMAPITable::QueryColumns de una tabla para recuperar la columna que contiene la propiedad PR_ENTRYID .
Los identificadores de entrada se pasan como parámetros a los métodos OpenEntry y CompareEntryIDs . Varios objetos MAPI implementan los métodos OpenEntry y CompareEntryIDs . Con OpenEntry, los clientes pueden abrir un objeto . Con CompareEntryIDs, los clientes pueden comparar dos identificadores de entrada para determinar si hacen referencia al mismo objeto. Dado que los identificadores de entrada no son necesariamente comparables binarios, los clientes deben compararlos mediante el método CompareEntryIDs .
Los clientes siempre deben pasar identificadores de entrada alineados de forma natural en sus llamadas a proveedores de servicios, ya que aunque los proveedores de servicios deben controlar los identificadores de entrada que están alineados arbitrariamente, esto no siempre es así. Una dirección de memoria alineada de forma natural permite al equipo acceder a cualquier tipo de datos que admita en esa dirección sin generar un error de alineación. El factor de alineación natural suele ser el mismo factor de alineación utilizado por el asignador de memoria del sistema y suele ser de 8 bytes.
Los identificadores de entrada se incluyen en dos tipos: a corto y largo plazo. Los identificadores de entrada a corto plazo son más rápidos de construir, pero su exclusividad solo se garantiza a lo largo de la vida útil de la sesión actual en la estación de trabajo actual. Los identificadores de entrada a largo plazo tienen una duración más prolongada. Los identificadores de entrada a corto plazo se usan principalmente para filas de tablas y entradas en cuadros de diálogo, mientras que los identificadores de entrada a largo plazo se usan para muchos objetos, como mensajes, carpetas y listas de distribución.