IMSLogon::OpenEntry
S’applique à : Outlook 2013 | Outlook 2016
Ouvre un dossier ou un objet message et retourne un pointeur vers l’objet pour fournir un accès supplémentaire.
HRESULT OpenEntry(
ULONG cbEntryID,
LPENTRYID lpEntryID,
LPCIID lpInterface,
ULONG ulOpenFlags,
ULONG FAR * lpulObjType,
LPUNKNOWN FAR * lppUnk
);
Paramètres
cbEntryID
[in] Taille, en octets, de l’identificateur d’entrée pointé par le paramètre lpEntryID .
lpEntryID
[in] Pointeur vers l’adresse de l’identificateur d’entrée du dossier ou de l’objet message à ouvrir.
lpInterface
[in] Pointeur vers l’identificateur d’interface (IID) de l’objet . La transmission de la valeur NULL indique que l’objet est converti en interface standard pour un tel objet. Le paramètre lpInterface peut également être défini sur un identificateur pour une interface appropriée pour l’objet .
ulOpenFlags
[in] Masque de bits d’indicateurs qui contrôle la façon dont l’objet est ouvert. Les indicateurs suivants peuvent être définis :
MAPI_BEST_ACCESS
L’objet doit être ouvert avec les autorisations maximales autorisées pour l’utilisateur et le nombre maximal d’autorisations d’application cliente. Par exemple, si le client dispose d’une autorisation de lecture/écriture, l’objet est ouvert avec l’autorisation de lecture/écriture ; si le client dispose d’une autorisation en lecture seule, l’objet est ouvert avec l’autorisation en lecture seule. Le client peut récupérer le niveau d’autorisation en obtenant la propriété PR_ACCESS_LEVEL (PidTagAccessLevel).
MAPI_DEFERRED_ERRORS
L’appel est autorisé à réussir même si l’objet sous-jacent n’est pas disponible pour l’application appelante. Si l’objet n’est pas disponible, un appel ultérieur à l’objet peut renvoyer une erreur.
MAPI_MODIFY
Demande l’autorisation de lecture/écriture. Par défaut, les objets sont créés avec une autorisation en lecture seule, et les clients ne doivent pas fonctionner selon l’hypothèse selon laquelle l’autorisation de lecture/écriture a été accordée.
lpulObjType
[out] Pointeur vers le type de l’objet ouvert.
lppUnk
[out] Pointeur vers le pointeur vers l’objet ouvert.
Valeur renvoyée
S_OK
L'appel a r�ussi et a renvoy� la valeur attendue ou les valeurs.
Remarques
MAPI appelle la méthode IMSLogon ::OpenEntry pour ouvrir un dossier ou un message dans une banque de messages. MAPI transmet l’identificateur d’entrée de l’objet à ouvrir. Le fournisseur de magasin de messages doit retourner un pointeur qui permet un accès supplémentaire à l’objet spécifié dans le paramètre lppUnk .
Avant que MAPI appelle IMSLogon ::OpenEntry, il détermine d’abord que l’identificateur d’entrée de message ou de dossier donné correspond à un identificateur inscrit par ce fournisseur de magasin de messages. Pour plus d’informations sur la façon dont les fournisseurs de magasins inscrivent les identificateurs d’entrée, consultez IMAPISupport ::SetProviderUID.
IMSLogon ::OpenEntry est identique à la méthode IMsgStore ::OpenEntry de l’objet de la banque de messages, sauf que le client n’appelle pas IMSLogon ::OpenEntry ; MAPI appelle IMSLogon ::OpenEntry lorsqu’il traite une méthode IMAPISession ::OpenEntry . Les objets ouverts à l’aide d’IMSLogon ::OpenEntry doivent être traités exactement de la même façon que les objets ouverts à l’aide de l’objet de la banque de messages ; en particulier, les objets ouverts à l’aide de cet appel doivent être invalidés lorsque l’objet de la banque de messages est libéré.