IMsgStore::SetReceiveFolder
Hace referencia a: Outlook 2013 | Outlook 2016
Establece una carpeta como destino de los mensajes entrantes de una clase de mensaje determinada.
HRESULT SetReceiveFolder(
LPSTR lpszMessageClass,
ULONG ulFlags,
ULONG cbEntryID,
LPENTRYID lpEntryID
);
Parameters
lpszMessageClass
[in] Puntero a la clase de mensaje que se va a asociar a la nueva carpeta de recepción. Si el parámetro lpszMessageClass se establece en NULL o en una cadena vacía, SetReceiveFolder establece la carpeta de recepción predeterminada para el almacén de mensajes.
ulFlags
[in] Máscara de bits de marcas que controla el tipo de texto en las cadenas pasadas. Se puede establecer la marca siguiente:
MAPI_UNICODE
La cadena de clase de mensaje está en formato Unicode. Si no se establece la marca de MAPI_UNICODE, la cadena de clase de mensaje está en formato ANSI.
cbEntryID
[in] Recuento de bytes en el identificador de entrada al que apunta el parámetro lpEntryID .
lpEntryID
[in] Puntero al identificador de entrada de la carpeta que se va a establecer como carpeta de recepción. Si el parámetro lpEntryID se establece en NULL, SetReceiveFolder reemplaza la carpeta de recepción actual por la predeterminada del almacén de mensajes.
Valor devuelto
S_OK
Se estableció correctamente una carpeta de recepción.
Comentarios
El método IMsgStore::SetReceiveFolder establece o cambia la carpeta de recepción para una clase de mensaje determinada. Con SetReceiveFolder, un cliente puede, mediante llamadas sucesivas, especificar una carpeta de recepción diferente para cada clase de mensaje definida o especificar que los mensajes entrantes para varias clases de mensaje vayan a la misma carpeta. Por ejemplo, un cliente puede tener su propia clase de mensajes llegar a su propia carpeta. Una aplicación de fax puede designar una carpeta en la que el proveedor de almacén coloca los faxes entrantes y otra carpeta en la que el proveedor coloca los faxes salientes.
Si se produce un error durante la llamada a SetReceiveFolder, la configuración de la carpeta de recepción permanece sin cambios.
Si SetReceiveFolder cambia la configuración de la carpeta de recepción con lpEntryID establecido en NULL, lo que indica que se debe establecer la carpeta de recepción predeterminada, SetReceiveFolder devuelve S_OK incluso si no había ninguna configuración existente para la clase de mensaje indicada.
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| MsgStoreDlg.cpp |
CMsgStoreDlg::OnSetReceiveFolder |
MFCMAPI usa el método IMsgStore::SetReceiveFolder para establecer una carpeta como carpeta de recepción para una clase de mensaje determinada. |