Compartir a través de

Acerca de las direcciones URL mapi para la indexación de Notification-Based

Hace referencia a: Outlook 2013 | Outlook 2016

Cuando un proveedor de almacén notifica a un indexador que un objeto está listo para la indexación, genera una dirección URL MAPI que identifica de forma única el objeto en el controlador de protocolo MAPI. Las direcciones URL MAPI se codifican en Unicode y tienen el formato siguiente:

Mapi://SID/StoreDisplayName ($HashNumber)/StoreType/FolderNameA/…/FolderNameN/[EntryIDEncoded[/at=AttachIDEncoded:FileName]]

En la tabla siguiente se describen las distintas partes de una dirección URL típica.

Parte Descripción
SID Identificador de seguridad del usuario actual.
StoreDisplayName Cadena que especifica el nombre para mostrar del usuario en ese almacén.
HashNumber DWORD en representación hexadecimal que se calcula en función del identificador de entrada de almacén o la firma de asignación de almacén. Este valor se almacena en el Registro y se usará más adelante para identificar el almacén en el controlador de protocolo MAPI.

Este número se debe calcular de forma que se minimicen las colisiones con otros almacenes. Para obtener el algoritmo que Usa Microsoft Outlook para calcular el número hash, vea Algoritmo para calcular el número hash de almacén.
StoreType Número que identifica el tipo del almacén que contiene el objeto que se va a indexar. Los valores posibles son los siguientes:
- 0 : almacén predeterminado.

- 1: almacén delegado, que se usa para delegar elementos almacenados en caché localmente.

- 2 - Carpetas públicas, usadas para favoritos de carpetas públicas.

NOTA: Si el almacén se está rastreando en lugar de insertarlo, el valor que se usa es el carácterX.
FolderNameA/.../FolderNameN Ruta de acceso de la raíz del IPM_SUBTREE a la carpeta o mensaje. Por ejemplo, un mensaje de la carpeta Familia en Bandeja de entrada tiene Bandeja de entrada/Familia para este parámetro.
EntryIDEncoded Identificador de entrada MAPI para el elemento codificado como una cadena Unicode. Consulte la sección siguiente "Caracteres especiales" para obtener información sobre cómo se codifican determinados caracteres especiales. Para obtener más información sobre el algoritmo para codificar el identificador de entrada, vea Algoritmo para codificar identificadores de entrada e identificadores de datos adjuntos.

NOTA: Cuando se ve como texto, este identificador de entrada codificado aparece como caracteres o cuadros hangul aleatorios de acuerdo con el algoritmo, dependiendo de las fuentes disponibles.
AttachIDEncoded Identificador de datos adjuntos codificado como una cadena Unicode. Consulte la sección siguiente "Caracteres especiales" para obtener información sobre cómo se codifican determinados caracteres especiales. Para obtener más información sobre el algoritmo para codificar el identificador de entrada, vea Algoritmo para codificar identificadores de entrada e identificadores de datos adjuntos.

NOTA: Cuando se ve como texto, este identificador de entrada codificado aparece como caracteres o cuadros hangul aleatorios de acuerdo con el algoritmo, dependiendo de las fuentes disponibles.
FileName Nombre del archivo adjunto, tal como aparece en el mensaje.

Ejemplos de direcciones URL MAPI

A continuación se muestran algunos ejemplos de direcciones URL MAPI.

  • Dirección URL MAPI para una carpeta:

    mapi://S-1-5-21-2127521184-1604012920-1887927527-71418/Mailbox - Some User ($be19928f)/2/Office

  • Dirección URL mapi para un mensaje:

    mapi://S-1-5-21-2127521184-1604012920-1887927527-71418/Mailbox - Some User ($484efb89)/0/Calendar/곯가가가걍걝걌곌겷걢곒갑겛개가검걟곔걙곾걤곂갠가

  • Dirección URL MAPI para datos adjuntos:

    mapi://S-1-5-21-2127521184-1604012920-1887927527-71418/Mailbox - Some User ($484efb89)/0/Inbox/곯가가가걍걝걌곌겷걢곒갑겛개가검걟곔걙곾간곷갦가/at=겅걋각가:somefile.txt

Caracteres especiales

Algunos caracteres se codifican si aparecen en el mensaje o los datos adjuntos. A continuación se muestra qué caracteres se codifican en una dirección URL MAPI:

  • % > %25

  • / > %2F

  • \ > %5C

  • * > %2A

  • ? > %3F

Blob asociado a cada dirección URL MAPI

Al insertar una dirección URL MAPI para que un objeto se indexe, un proveedor de almacén también crea un objeto binario grande (BLOB) que contiene cierta información para el controlador de protocolo MAPI. El proveedor de almacén asocia este BLOB a cada dirección URL MAPI y lo envía al insertar la dirección URL mapi en el indexador. El formato del BLOB es el siguiente:

DWORD  dwVersion
DWORD  dwFlags
ULONG  cbProfileName
WCHAR  wszProfileName
ULONG  cbProviderItemID
WCHAR  wszProviderItemID

El proveedor de almacén debe escribir estos valores en el BLOB en el orden mostrado. En la tabla siguiente se describe cada campo del BLOB.

Parte Descripción
dwVersion Esta es la versión de los datos que se envían. Actualmente este valor es 1.
Dwflags Reservado para uso futuro. Actualmente este valor debe ser 0.
cbProfileName Tamaño del nombre del perfil, en bytes. Esta información es útil para que el controlador de protocolo MAPI sepa qué perfil usar al indexar el elemento.
wszProfileName Cadena Unicode terminada en NULL que contiene el nombre del perfil.
cbProviderItemID Tamaño del identificador de elemento del proveedor, en bytes. El proveedor de almacén solo debe enviar el identificador de elemento de proveedor para las carpetas, para evitar abrir carpetas adicionales para obtener esta información.
wszProviderItemID Cadena Unicode terminada en null con el identificador de elemento del proveedor que identifica de forma única el elemento en el almacén.

Vea también