HrOpenOfflineObj

S’applique à : Outlook 2013 | Outlook 2016

Ouvre un objet hors connexion basé sur un profil donné.

Informations rapides

typedef HRESULT (STDMETHODCALLTYPE HROPENOFFLINEOBJ)( 
      ULONG ulReserved, 
      LPCWSTR pwszProfileNameIn, 
      const GUID* pGUID, 
      const GUID* pReserved, 
      IMAPIOfflineMgr** ppOfflineObj); 

Paramètres

ulReserved

[in] Ce paramètre n’est pas utilisé. Il doit être 0.

pwszProfileNameIn

[in] Nom du profil pour lequel l’objet hors connexion est destiné. Elle doit être exprimée en Unicode.

pGUID

[in] Pointeur vers un GUID qui peut être utilisé pour identifier cet objet de manière unique à partir d’autres objets hors connexion. Il doit être GUID_GlobalState.

Conservés

[in] Ce paramètre n’est pas utilisé. Elle doit être null.

ppOfflineObj

[out] Pointeur vers l’objet hors connexion demandé. L’appelant peut utiliser ce pointeur pour accéder à l’interface IMAPIOfflineMgr : IMAPIOffline pour rechercher les rappels pris en charge par cet objet et configurer les rappels pour celui-ci.

Valeurs de retour

S_OK

• L’appel de fonction a réussi.

MAPI_E_NOT_FOUND

• Échec de l’appel de fonction.

Remarques

Il s’agit du premier appel qu’un client effectue lorsqu’il souhaite être averti de toute modification de l’état de connexion pour un profil donné. Lors de l’appel de HrOpenOfflineObj, le client obtient un objet hors connexion qui prend en charge IMAPIOfflineMgr. Le client peut case activée pour les types de rappels pris en charge par l’objet (à l’aide de IMAPIOffline ::GetCapabilities), puis configurer des rappels pour celui-ci (à l’aide de IMAPIOfflineMgr ::Advise).

Lorsque vous utilisez GetProcAddress pour rechercher l’adresse de cette fonction dans msmapi32.dll, spécifiez HrOpenOfflineObj@20 comme nom de procédure.

HrOpenOfflineObj fonctionne uniquement pour les clients qui sont des fournisseurs MAPI, des compléments COM et des extensions clientes Exchange s’exécutant dans le processus Outlook. Sinon, HrOpenOfflineObj retourne MAPI_E_NOT_FOUND.

Voir aussi

IMAPIOffline : IUnknown

IMAPIOfflineMgr : IMAPIOffline

À propos de l’API d’état hors connexion

Constantes MAPI