IMAPISession::SetDefaultStore
S’applique à : Outlook 2013 | Outlook 2016
Établit une banque de messages en tant que magasin de messages par défaut pour la session.
HRESULT SetDefaultStore(
ULONG ulFlags,
ULONG cbEntryID,
LPENTRYID lpEntryID
);
Paramètres
ulFlags
[in] Masque de bits d’indicateurs qui contrôle le paramètre de la banque de messages par défaut. Ces indicateurs s’excluent mutuellement ; un seul des indicateurs suivants peut être défini :
MAPI_DEFAULT_STORE
Établit la banque de messages comme valeur par défaut de la session. Mises à jour la ligne de table status de la banque de messages en définissant l’indicateur STATUS_DEFAULT_STORE dans la colonne PR_RESOURCE_FLAGS (PidTagResourceFlags).
MAPI_PRIMARY_STORE
Établit la banque de messages en tant que magasin à utiliser lors de l’ouverture de session. Si la banque de messages n’est pas la banque par défaut, les clients doivent en faire la valeur par défaut. Mises à jour la ligne de table status de la banque de messages en définissant l’indicateur STATUS_PRIMARY_STORE dans la colonne PR_RESOURCE_FLAGS.
MAPI_SECONDARY_STORE
Établit la banque de messages en tant que magasin à utiliser lors de l’ouverture de session si la banque de messages principale n’est pas disponible. Si un client ne peut pas ouvrir le magasin principal, il doit ouvrir le magasin secondaire et le définir comme magasin par défaut. Mises à jour la ligne de table status de la banque de messages en définissant l’indicateur STATUS_SECONDARY_STORE dans la colonne PR_RESOURCE_FLAGS.
MAPI_SIMPLE_STORE_PERMANENT
Définit l’indicateur STATUS_SIMPLE_STORE dans la propriété PR_RESOURCE_FLAGS de la banque de messages dans sa ligne de table status, la ligne de la table de la banque de messages et dans le profil de session.
MAPI_SIMPLE_STORE_TEMPORARY
Définit l’indicateur STATUS_SIMPLE_STORE dans la propriété PR_RESOURCE_FLAGS de la banque de messages dans sa ligne de table status et la ligne de la table de la banque de messages. Le profil n’est pas modifié.
cbEntryID
[in] Nombre d’octets dans l’identificateur d’entrée vers lequel pointe le paramètre lpEntryID .
lpEntryID
[in] Pointeur vers l’identificateur d’entrée de la banque de messages qui est conçu comme valeur par défaut. Si un client passe NULL dans lpEntryID, aucune banque de messages n’est sélectionnée comme valeur par défaut.
Valeur renvoyée
S_OK
L’appel a réussi et a retourné la ou les valeurs attendues.
Remarques
La méthode IMAPISession ::SetDefaultStore établit une banque de messages comme suit :
Magasin de messages par défaut pour la session.
Magasin de messages principal de la session.
Magasin de messages secondaire pour la session.
Pour établir une banque de messages par défaut, les indicateurs suivants doivent être définis dans sa propriété PR_STORE_SUPPORT_MASK (PidTagStoreSupportMask) :
STORE_SUBMIT_OK
STORE_CREATE_OK
STORE_MODIFY_OK
Remarques pour les appelants
Vous pouvez déterminer la banque de messages par défaut pour la session en récupérant la table status et en recherchant le paramètre de l’indicateur STATUS_DEFAULT_STORE dans la colonne PR_RESOURCE_FLAGS. La ligne qui a ce paramètre représente la banque de messages désignée comme valeur par défaut de la session.
Lorsque l’indicateur MAPI_DEFAULT_STORE ou MAPI_SIMPLE_STORE_PERMANENT est défini, MAPI met à jour le profil, la table de la banque de messages et status table.
Chaque fois qu’une modification est apportée au paramètre par défaut de la banque de messages, les notifications suivantes sont générées :
Une notification d’événement fnevTableModified est émise pour chaque ligne affectée dans la banque de messages et la table status.
Une notification interne est envoyée au spouleur MAPI. Les opérations déjà en cours sont effectuées sans modification ; Les nouvelles opérations qui impliquent la banque de messages par défaut, telles que le téléchargement de messages, sont traitées pour le nouveau magasin par défaut.
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
| Fichier | Fonction | Commentaire |
|---|---|---|
| MainDlg.cpp |
CMainDlg ::OnSetDefaultStore |
MFCMAPI utilise la méthode IMAPISession ::SetDefaultStore pour définir le magasin sélectionné comme magasin par défaut. |
Voir aussi
Propriété canonique PidTagResourceFlags