IMAPISupport::OpenProfileSection
S’applique à : Outlook 2013 | Outlook 2016
Ouvre une section du profil actuel et retourne un pointeur IProfSect pour un accès supplémentaire.
HRESULT OpenProfileSection(
LPMAPIUID lpUid,
ULONG ulFlags,
LPPROFSECT FAR * lppProfileObj
);
Paramètres
lpUid
[in] Pointeur vers la structure MAPIUID qui identifie la section de profil à ouvrir. Le passage de la valeur NULL pour le paramètre lpUid ouvre la section du profil de l’appelant.
ulFlags
[in] Masque de bits d’indicateurs qui contrôle la façon dont la section de profil est ouverte. Les indicateurs suivants peuvent être définis :
MAPI_DEFERRED_ERRORS
Permet à OpenProfileSection de retourner avec succès, éventuellement avant que la section de profil ne soit entièrement accessible à l’appelant. Si la section de profil n’est pas accessible, l’exécution d’un appel d’objet suivant peut entraîner une erreur.
MAPI_MODIFY
Demande l’autorisation de lecture/écriture. Par défaut, les objets sont ouverts en lecture seule et les appelants ne doivent pas travailler sur l’hypothèse que l’autorisation de lecture/écriture a été accordée.
lppProfileObj
[out] Pointeur vers un pointeur vers la section de profil ouverte.
Valeur renvoyée
S_OK
La section profil a été ouverte avec succès.
MAPI_E_NO_ACCESS
Une tentative a été effectuée pour modifier une section de profil en lecture seule ou pour accéder à un objet pour lequel l’appelant n’a pas les autorisations suffisantes.
MAPI_E_NOT_FOUND
Aucune section de profil n’est associée à l’identificateur d’entrée passé dans lpEntryID.
MAPI_E_UNKNOWN_FLAGS
Des indicateurs réservés ou non pris en charge ont été utilisés et, par conséquent, l’opération ne s’est pas terminée.
Remarques
La méthode IMAPISupport ::OpenProfileSection est implémentée pour tous les objets de support. Les fournisseurs de services et les services de messagerie appellent OpenProfileSection pour ouvrir une section de profil et récupérer un pointeur vers son implémentation d’interface IProfSect .
Remarques pour les appelants
OpenProfileSection ouvre les sections de profil en lecture seule, sauf si vous définissez l’indicateur MAPI_MODIFY dans le paramètre ulFlags et que votre autorisation est suffisante. La définition de cet indicateur ne garantit pas l’autorisation de lecture/écriture ; Les autorisations qui vous sont accordées dépendent de votre niveau d’accès et de l’objet.
Si OpenProfileSection tente d’ouvrir une section de profil inexistante en lecture seule, il retourne MAPI_E_NOT_FOUND. Si OpenProfileSection tente d’ouvrir une section de profil inexistante en lecture/écriture, il crée la section de profil et retourne le pointeur IProfSect .