HrOpenABEntryWithExchangeContext
S’applique à : Outlook 2013 | Outlook 2016
Ouvre l’id d’entrée à l’aide du carnet d’adresses Exchange identifié par pEmsmdbUID. Cette fonction fonctionne de la même façon que IAddrBook ::D tails , 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 HrDoABDetailsWithExchangeContext(
LPMAPISESSION pmsess,
const MAPIUID *pEmsmdbUID,
LPADRBOOK pAddrBook,
ULONG cbEntryID,
LPENTRYID lpEntryID,
LPCIID lpInterface,
ULONG ulFlags
);
pmsess
[in] connecté à IMAPISession. Elle ne peut pas être NULL.
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.
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.