HrOpenABEntryWithProviderUID

S’applique à : Outlook 2013 | Outlook 2016

Ouvre l’id d’entrée à l’aide du carnet d’adresses Exchange identifié par pEmsabpUID. Cette fonction fonctionne de la même façon que IAddrBook ::OpenEntry , sauf que l’utilisation de cette fonction garantit que IAddrBook ::OpenEntry est ouvert à l’aide du fournisseur de carnet d’adresses Exchange attendu.

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

HRESULT HrOpenABEntryWithProviderUID(
  const MAPIUID *pEmsabpUID,
  LPADRBOOK pAddrBook,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPCIID lpInterface,
  ULONG ulFlags,
  ULONG FAR * lpulObjType,
  LPUNKNOWN FAR * lppUnk
);

Paramètres

pEmsmdbUID

[in] Pointeur vers un emsmdbUID qui identifie le service Exchange qui contient le fournisseur de carnets d’adresses Exchange que cette fonction doit utiliser pour afficher des détails sur l’identificateur d’entrée. Si l’identificateur d’entrée entrant n’est pas un identificateur d’entrée fournisseur de carnet d’adresses Exchange, ce paramètre est ignoré et l’appel de fonction se comporte comme IAddrBook ::D etails. Si ce paramètre a la valeur NULL ou un MAPIUID zéro, cette fonction se comporte comme IAddrBook ::D etails.

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 : IMAPIContaineret, 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

Utilisez 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

Utilisez uniquement la liste d’adresses gal 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’utilisez 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.