IMSLogon::OpenStatusEntry
S’applique à : Outlook 2013 | Outlook 2016
Ouvre un objet status.
HRESULT OpenStatusEntry(
LPCIID lpInterface,
ULONG ulFlags,
ULONG FAR * lpulObjType,
LPVOID FAR * lppEntry
);
Paramètres
lpInterface
[in] Pointeur vers l’identificateur d’interface (IID) pour l’objet status à ouvrir. Le passage de la valeur NULL indique que l’interface standard de l’objet est retournée (dans ce cas, l’interface IMAPIStatus ). Le paramètre lpInterface peut également être défini sur un identificateur pour une interface appropriée pour l’objet .
ulFlags
[in] Masque de bits d’indicateurs qui contrôle la façon dont l’objet status est ouvert. L’indicateur suivant peut être défini :
MAPI_MODIFY
Demande l’autorisation de lecture/écriture. Par défaut, les objets sont créés avec une autorisation en lecture seule, et les applications clientes ne doivent pas fonctionner en supposant que l’autorisation de lecture/écriture a été accordée.
lpulObjType
[out] Pointeur vers le type de l’objet ouvert.
lppEntry
[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
Les fournisseurs de magasins de messages implémentent la méthode IMSLogon ::OpenStatusEntry pour ouvrir un objet status. Cet objet status est ensuite utilisé pour permettre aux clients d’appeler des méthodes IMAPIStatus. Par exemple, les clients peuvent utiliser la méthode IMAPIStatus ::SettingsDialog pour reconfigurer la session d’ouverture de session de la banque de messages ou la méthode IMAPIStatus ::ValidateState pour valider l’état de la session d’ouverture de session de la banque de messages.