IMsgServiceAdmin::OpenProfileSection

Article
04/04/2023

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

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. La transmission de la valeur NULL entraîne le retour d’un pointeur vers son interface standard dans le paramètre lppProfSect . L’interface standard d’une section de profil est 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 générer une erreur.

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.

MAPI_FORCE_ACCESS

Autorise l’accès à toutes les sections de profil, même celles appartenant à des fournisseurs de services individuels.

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 IMsgServiceAdmin ::OpenProfileSection ouvre une section de profil, 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.

OpenProfileSection ne peut pas être utilisé pour ouvrir des sections de profil appartenant à des fournisseurs de services individuels, sauf si MAPI_FORCE_ACCESS est utilisé.

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.