IMsgStore::SetReceiveFolder
S’applique à : Outlook 2013 | Outlook 2016
Établit un dossier comme destination pour les messages entrants d’une classe de message particulière.
HRESULT SetReceiveFolder(
LPSTR lpszMessageClass,
ULONG ulFlags,
ULONG cbEntryID,
LPENTRYID lpEntryID
);
Paramètres
lpszMessageClass
[in] Pointeur vers la classe de message qui doit être associée au nouveau dossier de réception. Si le paramètre lpszMessageClass a la valeur NULL ou une chaîne vide, SetReceiveFolder définit le dossier de réception par défaut pour la banque de messages.
ulFlags
[in] Masque de bits d’indicateurs qui contrôle le type du texte dans les chaînes passées. L’indicateur suivant peut être défini :
MAPI_UNICODE
La chaîne de classe de message est au format Unicode. Si l’indicateur MAPI_UNICODE n’est pas défini, la chaîne de classe de message est au format ANSI.
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 du dossier à établir comme dossier de réception. Si le paramètre lpEntryID est défini sur NULL, SetReceiveFolder remplace le dossier de réception actuel par la valeur par défaut de la banque de messages.
Valeur renvoyée
S_OK
Un dossier de réception a été correctement établi.
Remarques
La méthode IMsgStore ::SetReceiveFolder définit ou modifie le dossier receive pour une classe de message particulière. Avec SetReceiveFolder, un client peut, à l’aide d’appels successifs, spécifier un dossier de réception différent pour chaque classe de message définie ou spécifier que les messages entrants pour plusieurs classes de message vont tous dans le même dossier. Par exemple, un client peut avoir sa propre classe de messages arrivant dans son propre dossier. Une application de télécopie peut désigner un dossier dans lequel le fournisseur de magasin place les télécopies entrantes et un autre dossier dans lequel le fournisseur place les télécopies sortantes.
Si une erreur se produit pendant l’appel à SetReceiveFolder, le paramètre de dossier de réception reste inchangé.
Si SetReceiveFolder modifie le paramètre du dossier de réception avec lpEntryID défini sur NULL, indiquant que le dossier de réception par défaut doit être défini, SetReceiveFolder retourne S_OK même s’il n’existait aucun paramètre pour la classe de message indiquée.
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
| Fichier | Fonction | Commentaire |
|---|---|---|
| MsgStoreDlg.cpp |
CMsgStoreDlg ::OnSetReceiveFolder |
MFCMAPI utilise la méthode IMsgStore ::SetReceiveFolder pour définir un dossier comme dossier de réception pour une classe de message particulière. |