HrOpenABEntryUsingDefaultContext

S’applique à : Outlook 2013 | Outlook 2016

Exécute la même fonction que HrOpenABEntryWithExchangeContext , sauf qu’il utilise l’emsmdbUID hérité comme paramètre pEmsmdbUID . N’utilisez pas cette fonction, sauf si vous ne pouvez pas obtenir l’emsmdbUID correct pour l’appel à HrOpenABEntryWithExchangeContext.

Propriété	Valeur
Fichier d’en-tête :	abhelp.h
Implémenté par :	MAPI
Appelé par :	Applications clientes et fournisseurs de services

HRESULT HrOpenABEntryUsingDefaultContext(
  LPMAPISESSION pmsess,
  LPADRBOOK pAddrBook,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPCIID lpInterface,
  ULONG ulFlags,
  ULONG FAR * lpulObjType,
  LPUNKNOWN FAR * lppUnk
);

Paramètres

pmsess

[in] connecté à IMAPISession. Elle ne peut pas être NULL.

pAddrBook

[in] Carnet d’adresses utilisé pour ouvrir l’identificateur d’entrée. Elle ne peut pas être NULL.

cbEntryID

[in] Nombre d’octets de l’identificateur d’entrée spécifié par le paramètre lpEntryID .

lpEntryID

[in] Pointeur vers l’identificateur d’entrée qui représente l’entrée du carnet d’adresses à ouvrir.

lpInterface

[in] Pointeur vers l’identificateur d’interface (IID) de l’interface utilisée pour accéder à l’entrée ouverte. La transmission de la valeur NULL renvoie l’interface standard de l’objet . Pour les utilisateurs de messagerie, l’interface standard est IMailUser : IMAPIProp. Pour les listes de distribution, il s’agit de IDistList : IMAPIContainer, et pour les conteneurs, il s’agit de IABContainer : IMAPIContainer. Les appelants peuvent définir lpInterface sur l’interface standard appropriée ou une interface dans la hiérarchie d’héritage.

ulFlags

[in] Masque de bits d’indicateurs qui contrôle la façon dont l’entrée est ouverte. Les indicateurs suivants peuvent être définis :

MAPI_BEST_ACCESS

Demande que l’entrée soit ouverte avec les autorisations réseau et client maximales autorisées. Par exemple, si le client dispose d’autorisations de lecture et d’écriture, le fournisseur de carnet d’adresses tente d’ouvrir l’entrée avec l’autorisation de lecture et d’écriture. Le client peut récupérer le niveau d’accès accordé en appelant la méthode IMAPIProp ::GetProps de l’entrée ouverte et en récupérant la propriété PR_ACCESS_LEVEL (PidTagAccessLevel).

MAPI_CACHE_ONLY

Utilise uniquement le carnet d’adresses en mode hors connexion pour effectuer la résolution de noms. Par exemple, vous pouvez utiliser cet indicateur pour permettre à une application cliente d’ouvrir la liste d’adresses globale (GAL) en mode d’échange mis en cache et d’accéder à une entrée de ce carnet d’adresses à partir du cache sans créer de trafic entre le client et le serveur. Cet indicateur est pris en charge uniquement par le fournisseur de carnets d’adresses Exchange.

MAPI_DEFERRED_ERRORS

Permet à l’appel de réussir, potentiellement avant que l’entrée ne soit entièrement ouverte et disponible, ce qui implique que les appels suivants à l’entrée peuvent retourner une erreur.

MAPI_GAL_ONLY

Utilise uniquement la liste d’adresses générales pour effectuer la résolution de noms. Cet indicateur est pris en charge uniquement par le fournisseur de carnets d’adresses Exchange.

MAPI_MODIFY

Demande que l’entrée soit ouverte avec l’autorisation de lecture et d’écriture. Étant donné que les entrées sont ouvertes avec un accès en lecture seule par défaut, les clients ne doivent pas supposer que l’autorisation de lecture et d’écriture a été accordée, que MAPI_MODIFY soit défini ou non.

MAPI_NO_CACHE

N’utilise pas le carnet d’adresses en mode hors connexion pour effectuer la résolution de noms. Cet indicateur est pris en charge uniquement par le fournisseur de carnets d’adresses Exchange.

lpulObjType

[out] Pointeur vers le type de l’entrée ouverte.

lppUnk

[out] Pointeur vers un pointeur de l’entrée ouverte.