IMAPISession::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,
LPCIID lpInterface,
ULONG ulFlags,
LPPROFSECT FAR * lppProfSect
);
Paramètres
lpUID
[in] Pointeur vers la structure MAPIUID qui identifie la section de profil.
lpInterface
[in] Pointeur vers l’identificateur d’interface (IID) qui représente l’interface à utiliser pour accéder à la section de profil. Si vous passez NULL, le paramètre lppProfSect retourne un pointeur vers l’interface standard de la section de profil, IProfSect.
ulFlags
[in] Masque de bits d’indicateurs qui contrôle l’accès à la section de profil. 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 disponible pour le client appelant. Si la section de profil n’est pas disponible, un appel ultérieur peut entraîner une erreur.
MAPI_FORCE_ACCESS
Autorise l’accès à une section de profil qui n’appartient pas au fournisseur.
MAPI_MODIFY
Demande l’autorisation de lecture/écriture. Par défaut, les sections de profil sont ouvertes avec une autorisation en lecture seule, et les clients ne doivent pas travailler sur l’hypothèse selon laquelle l’autorisation de lecture/écriture a été accordée.
lppProfSect
[out] Pointeur vers un pointeur vers la section du profil.
Valeur renvoyée
S_OK
La section profil a été ouverte avec succès.
MAPI_E_NO_ACCESS
Une tentative d’accès à une section de profil pour laquelle l’appelant ne dispose pas des autorisations suffisantes a été effectuée.
MAPI_E_NOT_FOUND
La section de profil demandé n’existe pas.
Remarques
La méthode IMAPISession ::OpenProfileSection ouvre une section de profil ou un objet qui prend en charge l’interface IProfSect . Les sections de profil sont utilisées pour lire et écrire des informations dans le profil de session.
Vous ne pouvez pas utiliser OpenProfileSection pour ouvrir les sections de profil que possèdent des fournisseurs de services individuels, sauf si vous spécifiez MAPI_FORCE_ACCESS dans le paramètre ulFlags .
Remarques pour les appelants
Plusieurs clients peuvent ouvrir une section de profil avec une autorisation en lecture seule, mais un seul client peut ouvrir une section de profil avec une autorisation de lecture/écriture. Si un autre client a ouvert une section de profil que vous tentez d’ouvrir en appelant OpenProfileSection avec l’indicateur MAPI_MODIFY défini, l’appel échoue et retourne MAPI_E_NO_ACCESS.
Une opération d’ouverture en lecture seule échoue si la section est ouverte pour l’écriture.
Vous pouvez créer une section de profil en appelant OpenProfileSection avec l’indicateur MAPI_MODIFY et une structure MAPIUID inexistante dans le paramètre lpUID . Veillez à spécifier MAPI_MODIFY. Si vous définissez lpUID pour qu’il pointe vers un MAPIUID inexistant et que OpenProfileSection est défini pour utiliser le mode d’accès par défaut en lecture seule, l’appel échoue avec MAPI_E_NOT_FOUND.