IMAPISupport::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 en el formato estándar MAPI.
HRESULT WrapStoreEntryID(
ULONG cbOrigEntry,
LPENTRYID lpOrigEntry,
ULONG FAR * lpcbWrappedEntry,
LPENTRYID FAR * lppWrappedEntry
);
Parameters
cbOrigEntry
[in] Recuento de bytes en el identificador de entrada al que apunta el parámetro lpOrigEntry .
lpOrigEntry
[in] Puntero al identificador de entrada privada del almacén de mensajes.
lpcbWrappedEntry
[out] Puntero al recuento de bytes en el identificador de entrada al que apunta el parámetro lppWrappedEntry .
lppWrappedEntry
[out] Puntero a un puntero al identificador de entrada encapsulado.
Valor devuelto
S_OK
El identificador de entrada se ha ajustado correctamente.
Comentarios
El método IMAPISupport::WrapStoreEntryID se implementa para todos los objetos de soporte técnico del proveedor de servicios. Los proveedores de servicios usan WrapStoreEntryID para que MAPI genere un identificador de entrada para un almacén de mensajes que ajuste el identificador de entrada interno del almacén.
Notas para los llamadores
Cuando un cliente llama al método IMAPIProp::GetProps del almacén de mensajes para recuperar su propiedad PR_STORE_ENTRYID (PidTagStoreEntryId) y el almacén de mensajes usa un identificador de entrada en un formato privado, llame a WrapStoreEntryID y devuelva el identificador de entrada al que apunta el parámetro lppWrappedEntry .
Las llamadas a los métodos IMSProvider::Logon y IMSLogon::CompareEntryIDs siempre obtienen el identificador de entrada privada del almacén; la versión ajustada solo se usa entre las aplicaciones cliente y MAPI.
Libere la memoria del identificador de entrada al que apunta el parámetro lppWrappedEntry mediante la función MAPIFreeBuffer cuando haya terminado de usar el identificador de entrada.