WrapStoreEntryID

Hace referencia a: Outlook 2013 | Outlook 2016

Convierte el identificador de entrada interno de un almacén de mensajes en un identificador de entrada más utilizable por el sistema de mensajería.

Propiedad	Valor
Archivo de encabezado:	Mapidefs.h
Implementado por:	MAPI
Llamado por:	Aplicaciones cliente y proveedores de servicios

WrapStoreEntryID(
  ULONG ulFlags,
  LPSTR szDLLName,
  ULONG cbOrigEntry,
  LPENTRYID lpOrigEntry,
  ULONG * lpcbWrappedEntry,
  LPENTRYID * lppWrappedEntry
);

Parameters

ulFlags

[in] Máscara de bits de marcas. Se puede establecer la marca siguiente:

MAPI_UNICODE

Las cadenas están en formato Unicode. Si no se establece la marca de MAPI_UNICODE, las cadenas están en formato ANSI.

szDLLName

[in] Nombre del archivo DLL del proveedor de mensajes.

cbOrigEntry

[in] Tamaño, en bytes, del identificador de entrada original para el almacén de mensajes.

lpOrigEntry

[in] Puntero a una estructura ENTRYID que contiene el identificador de entrada original.

lpcbWrappedEntry

[out] Puntero al tamaño, en bytes, del nuevo identificador de entrada.

lppWrappedEntry

[out] Puntero a un puntero a una estructura ENTRYID que contiene el nuevo identificador de entrada.

Valor devuelto

Ninguno.

Comentarios

Un objeto de almacén de mensajes conserva un identificador de entrada interno que solo es significativo para los proveedores de servicios coresident con ese almacén de mensajes. Para otros componentes de mensajería, MAPI proporciona una versión ajustada del identificador de entrada interno que hace que sea reconocible como que pertenece al almacén de mensajes. A los proveedores de servicios coresident siempre se les debe proporcionar el identificador de entrada de almacén de mensajes no cifrado original; Las aplicaciones cliente siempre deben tener la versión encapsulada, que se puede usar en cualquier lugar del dominio de mensajería y en otros dominios.

Un proveedor de servicios puede encapsular un identificador de entrada del almacén de mensajes mediante la función WrapStoreEntryID o el método IMAPISupport::WrapStoreEntryID , que llama a la función WrapStoreEntryID . El proveedor debe encapsular el identificador de entrada al exponer la propiedad PR_ENTRYID del almacén de mensajes (PidTagEntryId) o escribirlo en una sección de perfil y al exponer la propiedad PR_STORE_ENTRYID (PidTagStoreEntryId). MAPI encapsula un identificador de entrada del almacén de mensajes al responder a una llamada IMAPISession::OpenMsgStore .

Cuando una aplicación cliente pasa un identificador de entrada de almacén de mensajes encapsulado a MAPI, por ejemplo, en una llamada IMAPISession::OpenEntry , MAPI desencapsula el identificador de entrada antes de usarlo para llamar a un método de proveedor como IMSProvider::Logon o IMSProvider::CompareStoreIDs.