Partager via


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.

Voir aussi

IMsgStore : IMAPIProp

MFCMAPI comme un exemple de Code