IMSLogon::OpenEntry
Hace referencia a: Outlook 2013 | Outlook 2016
Abre una carpeta o un objeto de mensaje y devuelve un puntero al objeto para proporcionar más acceso.
HRESULT OpenEntry(
ULONG cbEntryID,
LPENTRYID lpEntryID,
LPCIID lpInterface,
ULONG ulOpenFlags,
ULONG FAR * lpulObjType,
LPUNKNOWN FAR * lppUnk
);
Parameters
cbEntryID
[in] Tamaño, en bytes, del identificador de entrada al que apunta el parámetro lpEntryID .
lpEntryID
[in] Puntero a la dirección del identificador de entrada del objeto de carpeta o mensaje que se va a abrir.
lpInterface
[in] Puntero al identificador de interfaz (IID) para el objeto . Pasar NULL indica que el objeto se convierte en la interfaz estándar para este tipo de objeto. El parámetro lpInterface también se puede establecer en un identificador para una interfaz adecuada para el objeto.
ulOpenFlags
[in] Máscara de bits de marcas que controla cómo se abre el objeto. Se pueden establecer las siguientes marcas:
MAPI_BEST_ACCESS
El objeto debe abrirse con los permisos máximos permitidos para el usuario y el máximo de permisos de aplicación cliente. Por ejemplo, si el cliente tiene permiso de lectura y escritura, el objeto se abre con permiso de lectura y escritura; si el cliente tiene permiso de solo lectura, el objeto se abre con permiso de solo lectura. El cliente puede recuperar el nivel de permiso obteniendo la propiedad PR_ACCESS_LEVEL (PidTagAccessLevel).
MAPI_DEFERRED_ERRORS
La llamada puede realizarse correctamente incluso si el objeto subyacente no está disponible para la aplicación que realiza la llamada. Si el objeto no está disponible, una llamada posterior al objeto podría devolver un error.
MAPI_MODIFY
Solicita permiso de lectura y escritura. De forma predeterminada, los objetos se crean con permiso de solo lectura y los clientes no deben funcionar en la suposición de que se ha concedido el permiso de lectura y escritura.
lpulObjType
[out] Puntero al tipo del objeto abierto.
lppUnk
[out] Puntero al puntero al objeto abierto.
Valor devuelto
S_OK
La llamada se ha realizado correctamente y devuelva el valor esperado o los valores.
Comentarios
MAPI llama al método IMSLogon::OpenEntry para abrir una carpeta o un mensaje en un almacén de mensajes. MAPI pasa el identificador de entrada del objeto que se va a abrir. El proveedor del almacén de mensajes debe devolver un puntero que permita un mayor acceso al objeto especificado en el parámetro lppUnk .
Antes de que MAPI llame a IMSLogon::OpenEntry, primero determina que el identificador de entrada de carpeta o mensaje determinado coincide con uno registrado por este proveedor de almacén de mensajes. Para obtener más información sobre cómo los proveedores de almacén registran identificadores de entrada, vea IMAPISupport::SetProviderUID.
IMSLogon::OpenEntry es idéntico al método IMsgStore::OpenEntry del objeto de almacén de mensajes, salvo que el cliente no llama a IMSLogon::OpenEntry; MAPI llama a IMSLogon::OpenEntry cuando procesa un método IMAPISession::OpenEntry . Los objetos abiertos mediante IMSLogon::OpenEntry deben tratarse exactamente igual que los objetos abiertos mediante el objeto de almacén de mensajes; en concreto, los objetos abiertos mediante esta llamada deben invalidarse cuando se libera el objeto de almacén de mensajes.