Carpetas de MAPI
Hace referencia a: Outlook 2013 | Outlook 2016
Las carpetas son objetos MAPI que sirven como unidad b�sica de organizaci�n para los mensajes. Organizados jer�rquicamente, carpetas pueden contener otras carpetas y mensajes. Carpetas que m�s f�cil localizar y trabajar con los mensajes.
Carpetas de implementan la interfaz de IMAPIFolder , que indirectamente hereda de la interfaz de IUnknown a trav�s de la IMAPIContainer y las interfaces de IMAPIProp . Los clientes utilizan IMAPIFolder para crear, copiar y eliminar mensajes y carpetas, para recuperar y establecer el estado del mensaje y para activar o desactivar el indicador de lectura para un mensaje. Aunque los proveedores de almac�n de mensajes necesarios para admitir todos los m�todos en IMAPIFolder, algunos m�todos presentan un nivel de complejidad que los proveedores de almac�n de mensajes es posible que desee evitar. MAPI guarda alg�n trabajo de los proveedores de almac�n de mensajes mediante la implementaci�n de algunas de las funciones m�s complejas de carpeta en la interfaz de IMAPISupport . Por ejemplo, en lugar de implementar sus propios m�todos de copia, los proveedores de almac�n de mensajes pueden llamar a los m�todos de copia en el objeto de soporte t�cnico y obtener los mismos resultados.
Hay tres tipos de carpetas:
Carpetas ra�z.
Carpetas gen�ricas.
Carpetas de b�squeda
Cada almac�n de mensajes tiene al menos una carpeta ra�z. La carpeta ra�z aparece en la parte superior de la jerarqu�a y contiene los mensajes y otras carpetas. Carpetas ra�z no se pueden mover, copiar, cambiar el nombre o eliminar. Hay una sola carpeta ra�z de cada almac�n de mensajes.
La mayor�a de otra carpetas es gen�rica. Al igual que las carpetas ra�z, carpetas gen�ricas contienen mensajes y otras carpetas. A diferencia de las carpetas ra�z, pueden se movi�, copi�, cambiar el nombre y eliminados. Pueden crearse carpetas gen�ricas en la carpeta ra�z o en otras carpetas gen�ricos. Cuando un cliente crea una carpeta gen�rica en otra carpeta, la nueva carpeta se llama una subcarpeta o carpeta secundaria. La carpeta en la que se coloca la nueva carpeta se conoce como la carpeta principal de la nueva carpeta. Carpetas gen�ricas que tienen la misma carpeta primaria se denominan carpetas del mismo nivel. Elemento del mismo nivel y no relacionado carpetas posible o pueden que no tengan nombres �nicos, seg�n el mensaje de proveedor de almac�n. Proveedores de almac�n de mensajes que requieren las carpetas del mismo nivel que tengan nombres �nicos devuelven el valor de error MAPI_E_COLLISION cuando un cliente intenta crear dos carpetas con el mismo nombre en la misma forma primaria.
Una carpeta de búsqueda contiene vínculos a mensajes que coinciden con un conjunto de criterios predefinidos. Dado que las carpetas de búsqueda contienen vínculos en lugar de mensajes reales, están en vigor de solo lectura. No pueden contener otras carpetas ni tener mensajes o carpetas movidos o copiados en ellas. No pueden tener nuevos mensajes creados en ellos; y ellos mismos no se pueden mover, copiar ni cambiar de nombre. Cuando se elimina un mensaje de una carpeta de búsqueda, se elimina realmente de la carpeta que contiene el mensaje.
El tipo de carpeta se almacena en la propiedad PR_FOLDER_TYPE (PidTagFolderType). Cada carpeta tiene esta propiedad establecida en FOLDER_GENERIC, FOLDER_ROOT o FOLDER_SEARCH, dependiendo de su tipo.
Cada carpeta tiene el identificador de una entrada y una clave de registro. Los clientes y proveedores de servicios usan el identificador de entrada , PR_ENTRYID (PidTagEntryId), para abrir la carpeta. La clave de registro, PR_RECORD_KEY (PidTagRecordKey), es un valor binario que se usa para comparar la carpeta con otras carpetas.
Una carpeta tiene otras propiedades para identificar el almac�n de mensajes y carpetas relacionadas. Se requieren las siguientes propiedades:
PR_PARENT_ENTRYID (PidTagParentEntryId)
PR_STORE_ENTRYID (PidTagStoreEntryId)
PR_STORE_RECORD_KEY (PidTagStoreRecordKey)
Algunas carpetas admiten la propiedad PR_ACCESS (PidTagAccess) que describe el tipo de operaciones que un usuario puede realizar. Por ejemplo, uno de los valores v�lidos para PR_ACCESS es MAPI_ACCESS_DELETE, que indica que se puede quitar la carpeta. Otra opci�n, MAPI_ACCESS_MODIFY, indica que la carpeta debe ser modificable.
Para obtener una lista completa de propiedades de la carpeta requerida, vea la interfaz de IMAPIFolder .