Constantes MAPI
Hace referencia a: Outlook 2013 | Outlook 2016
Este tema contiene las definiciones de constantes, declaraciones de interfaz MAPI e identificadores de clase e interfaz usados por las API de MAPI.
Identificadores de clase e interfaz
Use la macro DEFINE_GUID definida en el archivo de encabezado guiddef.h del Kit de desarrollo de Software (SDK) de Microsoft Windows para asociar nombres simbólicos de identificador único global (GUID) con sus valores, a menos que se indique lo contrario.
API de conversión de seguridad de datos adjuntos
Esta sección contiene las definiciones de constantes e identificadores de interfaz de la API de seguridad de datos adjuntos
// {b2533636-c3f3-416f-bf04-aefe41abaae2}
DEFINE_GUID(IID_IAttachmentSecurity, 0xb2533636, 0xc3f3, 0x416f, 0xbf, 0x04, 0xae, 0xfe, 0x41, 0xab, 0xaa, 0xe2);
Utilice la macro MAPIMETHOD definida en el archivo de encabezado mapidefs.h de Windows SDK para definir la función virtual pura IsAttachmentBlocked.
#define MAPI_IATTACHMENTSECURITY_METHODS(IPURE) MAPIMETHOD(IsAttachmentBlocked) (LPCWSTR pwszFileName, BOOL *pfBlocked) IPURE;
Utilice la macro DECLARE_MAPI_INTERFACE_ definida en el archivo de encabezado mapidefs.h de Windows SDK para definir la tabla de método virtual de IAttachmentSecurity.
DECLARE_MAPI_INTERFACE_(IAttachmentSecurity, IUnknown)
{
BEGIN_INTERFACE
MAPI_IUNKNOWN_METHODS(PURE)
MAPI_IATTACHMENTSECURITY_METHODS(PURE)
};
API de conversión de MAPI-MIME
Esta sección contiene las definiciones de constantes e identificadores de clase e interfaz para la API de conversión de MAPI-MIME.
| Constante | Definición |
|---|---|
| CCSF_SMTP |
0x0002 |
| CCSF_NOHEADERS |
0x0004 |
| CCSF_USE_TNEF |
0x0010 |
| CCSF_INCLUDE_BCC |
0x0020 |
| CCSF_8BITHEADERS |
0x0040 |
| CCSF_USE_RTF |
0x0080 |
| CCSF_PLAIN_TEXT_ONLY |
0x1000 |
| CCSF_NO_MSGID |
0x4000 |
| CCSF_GLOBAL_MESSAGE |
0x00200000 |
| E_INVALIDARG |
Según se define en el archivo de encabezado winerror.h del Kit de desarrollo de Software (SDK) de Microsoft Windows |
Identificadores de clase
// {4e3a7680-b77a-11d0-9da5-00c04fd65685}
DEFINE_GUID(CLSID_IConverterSession, 0x4e3a7680, 0xb77a, 0x11d0, 0x9d, 0xa5, 0x0, 0xc0, 0x4f, 0xd6, 0x56, 0x85);
Identificadores de interfaz
// {4b401570-b77b-11d0-9da5-00c04fd65685}
DEFINE_GUID(IID_IConverterSession, 0x4b401570, 0xb77b, 0x11d0, 0x9d, 0xa5, 0x0, 0xc0, 0x4f, 0xd6, 0x56, 0x85);
API de estado sin conexión
Esta sección contiene las definiciones de constantes e identificadores de clase e interfaz para la API de estado sin conexión.
| Constante | Definición |
|---|---|
| E_INVALIDARG |
Según se define en el archivo de encabezado winerror.h del Kit de desarrollo de Software (SDK) de Microsoft Windows |
| E_NOINTERFACE |
Según se define en el archivo de encabezado winerror.h de Windows (SDK) de Windows |
| MAPIOFFLINE_ADVISE_DEFAULT |
(ULONG)0 |
| MAPIOFFLINE_UNADVISE_DEFAULT |
(ULONG)0 |
| MAPIOFFLINE_ADVISE_TYPE_STATECHANGE |
1 |
| MAPIOFFLINE_CAPABILITY_OFFLINE |
0x1 |
| MAPIOFFLINE_CAPABILITY_ONLINE |
0x2 |
| MAPIOFFLINE_FLAG_BLOCK |
0x00002000 |
| MAPIOFFLINE_FLAG_DEFAULT |
0x00000000 |
| MAPIOFFLINE_STATE_ALL |
0x003f037f |
|
En línea o sin conexión |
|
| MAPIOFFLINE_STATE_OFFLINE_MASK |
0x00000003 |
| MAPIOFFLINE_STATE_OFFLINE |
0x00000001 |
| MAPIOFFLINE_STATE_ONLINE |
0x00000002 |
Identificadores de clase
//{fbeffd93-b11f-4094-842b-96dcd31e63d1}
DEFINE_GUID(GUID_GlobalState, 0xfbeffd93, 0xb11f, 0x4094, 0x84, 0x2b, 0x96, 0xdc, 0xd3, 0x1e, 0x63, 0xd1);
Identificadores de interfaz
//{000672B5-0000-0000-c000-000000000046}
DEFINE_GUID(IID_IMAPIOffline, 0x000672B5, 0x0000, 0x0000, 0xc0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x46);
//{0317bde5-fc29-44cd-8dcd-36125a3be9ec}
DEFINE_GUID(IID_IMAPIOfflineNotify, 0x0317bde5, 0xfc29, 0x44cd, 0x8d, 0xcd, 0x36, 0x12, 0x5a, 0x3b, 0xe9, 0xec);
//{42175607-ff3e-4790-bc18-66c8643e6424
DEFINE_GUID(IID_IMAPIOfflineMgr, 0x42175607, 0xFF3E, 0x4790, 0xbc, 0x18, 0x66, 0xc8, 0x64, 0x3e, 0x64, 0x24);
Propiedades con nombre de Outlook
Esta sección contiene las definiciones de constantes de propiedades con nombre, sus espacios de nombres y otras constantes relacionadas.
Definiciones de propiedades con nombre
#define dispidMeetingType0x0026
#define dispidFileUnder0x8005
#define dispidYomiFirstName 0x802C
#define dispidYomiLastName 0x802D
#define dispidYomiCompanyName 0x802E
#define dispidWorkAddressStreet 0x8045
#define dispidWorkAddressCity 0x8046
#define dispidWorkAddressState 0x8047
#define dispidWorkAddressPostalCode 0x8048
#define dispidWorkAddressCountry 0x8049
#define dispidWorkAddressPostOfficeBox 0x804A
#define dispidInstMsg 0x8062
#define dispidEmailDisplayName 0x8080
#define dispidEmailAddrType 0x8082
#define dispidEmailEmailAddress 0x8083
#define dispidEmailOriginalDisplayName 0x8084
#define dispidEmail1OriginalEntryID0x8085
#define dispidEmail2DisplayName 0x8090
#define dispidEmail2AddrType 0x8092
#define dispidEmail2EmailAddress 0x8093
#define dispidEmail2OriginalDisplayName 0x8094
#define dispidEmail2OriginalEntryID0x8095
#define dispidEmail3DisplayName 0x80A0
#define dispidEmail3AddrType 0x80A2
#define dispidEmail3EmailAddress 0x80A3
#define dispidEmail3OriginalDisplayName 0x80A4
#define dispidEmail3OriginalEntryID0x80A5
#define dispidTaskStatus 0x8101
#define dispidTaskStartDate 0x8104
#define dispidTaskDueDate 0x8105
#define dispidTaskActualEffort 0x8110
#define dispidTaskEstimatedEffort 0x8111
#define dispidTaskFRecur 0x8126
#define dispidBusyStatus0x8205
#define dispidLocation 0x8208
#define dispidApptStartWhole 0x820D
#define dispidApptEndWhole 0x820E
#define dispidApptDuration 0x8213
#define dispidRecurring 0x8223
#define dispidTimeZoneStruct0x8233
#define dispidAllAttendeesString 0x8238
#define dispidToAttendeesString 0x823B
#define dispidCCAttendeesString 0x823C
#define dispidConfCheck0x8240
#define dispidApptCounterProposal 0x8257
#define dispidApptTZDefStartDisplay0x825E
#define dispidApptTZDefEndDisplay0x825F
#define dispidApptTZDefRecur0x8260
#define dispidReminderTime0x8502
#define dispidReminderSet 0x8503
#define dispidFormStorage0x850F
#define dispidPageDirStream0x8513
#define dispidSmartNoAttach 0x8514
#define dispidCommonStart 0x8516
#define dispidCommonEnd 0x8517
#define dispidFormPropStream0x851B
#define dispidRequest 0x8530
#define dispidCompanies 0x8539
#define dispidContacts0x853A
#define dispidPropDefStream0x8540
#define dispidScriptStream0x8541
#define dispidCustomFlag0x8542
#define dispidReminderNextTime 0x8560
#define dispidHeaderItem0x8578
#define dispidUseTNEF0x8582
#define dispidToDoTitle0x85A4
#define dispidLogType 0x8700
#define dispidLogStart 0x8706
#define dispidLogDuration 0x8707
#define dispidLogEnd 0x8708
Definiciones de espacios de nombres
Los siguientes identificadores únicos globales (GUID) representan los espacios de nombres de las propiedades con nombre.
const GUID PS_INTERNET_HEADERS = {0x00020386, 0x0000, 0x0000, {0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46}};
const GUID PS_PUBLIC_STRINGS = {0x00020329, 0x0000, 0x0000, {0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46}};
const GUID PSETID_Appointment= {0x00062002, 0x0000, 0x0000, {0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46}};
const GUID PSETID_Address = {0x00062004, 0x0000, 0x0000, {0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46}};
const GUID PSETID_Common = {0x00062008, 0x0000, 0x0000, {0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46}};
const GUID PSETID_Log = {0x0006200A, 0x0000, 0x0000, {0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46}};
const GUID PSETID_Meeting = {0x6ED8DA90, 0x450B, 0x101B, {0x98, 0xDA, 0x00, 0xAA, 0x00, 0x3F, 0x13, 0x05}};
const GUID PSETID_Task = {0x00062003, 0x0000, 0x0000, {0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46}};
Consulte la sección del almacén de MAPI para las definiciones de PSETID.
Otras constantes
| Constante | Definición |
|---|---|
| INSP_ONEOFFFLAGS |
0xD000000 |
| INSP_PROPDEFINITION |
0x2000000 |
| MNID_ID |
Según se define en el archivo de encabezadomapidefs.h. |
| MNID_STRING |
Según se define en el archivo de encabezadomapidefs.h. |
| mtgNone |
0x0 |
| mtgRequest |
0x00000001 |
| mtgFullUpdate |
0x00010000 |
| mtgInfoUpdate |
0x00020000 |
| mtgOutofDate |
0x00080000 |
| mtgDelegated |
0x00100000 |
API de replicación
Esta sección contiene las definiciones de constantes, declaraciones de interfaz MAPI e identificadores de clase e interfaz de la API de replicación.
Esta es una estructura MAPIUID que identifica un proveedor de servicios MAPI:
const MAPIUID g_muidProvPrvNST =
{ 0xE9, 0x2F, 0xEB, 0x75, 0x96, 0x50, 0x44, 0x86,
0x83, 0xB8, 0x7D, 0xE5, 0x22, 0xAA, 0x49, 0x48 };
| Constante | Definición |
|---|---|
| DNH_OK |
0x00010000 |
| DNT_OK |
0x00010000 |
| HSF_LOCAL |
0x00000008 |
| HSF_COPYDESTRUCTIVE |
0x00000010 |
| HSF_OK |
0x00010000 |
| MDB_OST_LOGON_UNICODE |
((ULONG) 0x00000800) |
| MDB_OST_LOGON_ANSI |
((ULONG) 0x00001000) |
| SHOW_SOFT_DELETES |
((ULONG) 0x00000002) |
| SS_ACTIVE |
0 |
| SS_SUSPENDED |
1 |
| SYNC_UPLOAD_HIERARCHY |
0x00000001 |
| SYNC_DOWNLOAD_HIERARCHY |
0x00000002 |
| SYNC_UPLOAD_CONTENTS |
0x00000040 |
| SYNC_DOWNLOAD_CONTENTS |
0x00000080 |
| SYNC_OUTGOING_MAIL |
0x00000200 |
| SYNC_BACKGROUND |
0x00001000 |
| SYNC_THESE_FOLDERS |
0x00020000 |
| SYNC_HEADERS |
0x02000000 |
| UPC_OK |
0x00010000 |
| UPD_ASSOC |
0x00000001 |
| UPD_MOV |
0x00000002 |
| UPD_OK |
0x00010000 |
| UPD_MOVED |
0x00020000 |
| UPD_UPDATE |
0x00040000 |
| UPD_COMMIT |
0x00080000 |
| UPF_NEW |
0x00000001 |
| UPF_MOD_PARENT |
0x00000002 |
| UPF_MOD_PROPS |
0x00000004 |
| UPF_DEL |
0x00000008 |
| UPF_OK |
0x00010000 |
| UPH_OK |
0x00010000 |
| UPM_ASSOC |
0x00000001 |
| UPM_NEW |
0x00000002 |
| UPM_MOV |
0x00000004 |
| UPM_MOD_PROPS |
0x00000008 |
| UPM_HEADER |
0x00000010 |
| UPM_OK |
0x00010000 |
| UPM_MOVED |
0x00020000 |
| UPM_COMMIT |
0x00040000 |
| UPM_DELETE |
0x00080000 |
| UPM_SAVE |
0x00100000 |
| UPR_ASSOC |
0x00000001 |
| UPR_READ |
0x00000002 |
| UPR_OK |
0x00010000 |
| UPR_COMMIT |
0x00020000 |
| UPS_UPLOAD_ONLY |
0x00000001 |
| UPS_DNLOAD_ONLY |
0x00000002 |
| UPS_ONE_FOLDER |
0x00000004 |
| UPS_THESE_FOLDERS |
0x00000080 |
| UPS_OK |
0x00010000 |
| UPT_OK |
0x00010000 |
| UPT_PUBLIC |
0x00000001 |
| UPV_ERROR |
0x00010000 |
| UPV_DIRTY |
0x00020000 |
| UPV_COMMIT |
0x00040000 |
Declaraciones de interfaz
DECLARE_MAPI_INTERFACE_PTR(IExchangeImportHierarchyChanges,PXIHC);
DECLARE_MAPI_INTERFACE_PTR(IExchangeImportContentsChanges,PXICC);
Identificadores de interfaz
//{4FDEEFF0-0319-11CF-B4CF-00AA0DBBB6E6}
DEFINE_GUID (IID_IPSTX, 0x4FDEEFF0, 0x0319, 0x11CF, 0xB4, 0xCF, 0x00, 0xAA, 0x0D, 0xBB, 0xB6, 0xE6)
//{2067A790-2A45-11D1-EB86-00A0C90DCA6D}
DEFINE_GUID (IID_IPSTX2, 0x2067A790, 0x2A45, 0x11D1, 0xEB, 0x86, 0x00, 0xA0, 0xC9, 0x0D, 0xCA, 0x6D)
//{55f15320-111b-11d2-a999-006008b05aa7}
DEFINE_GUID (IID_IPSTX3, 0x55f15320, 0x111b, 0x11d2, 0xa9, 0x99, 0x00, 0x60, 0x08, 0xb0, 0x5a, 0xa7)
//{aa2e2092-ac08-11d2-a2f9-0060b0ec3d4f}
DEFINE_GUID (IID_IPSTX4, 0xaa2e2092, 0xac08, 0x11d2, 0xa2, 0xf9, 0x00, 0x60, 0xb0, 0xec, 0x3d, 0x4f)
//{55f15322-111b-11d2-a999-006008b05aa7}
DEFINE_GUID (IID_IPSTX5, 0x55f15322, 0x111b, 0x11d2, 0xa9, 0x99, 0x00, 0x60, 0x08, 0xb0, 0x5a, 0xa7)
//{55f15323-111b-11d2-a999-006008b05aa7}
DEFINE_GUID (IID_IPSTX6, 0x55f15323, 0x111b, 0x11d2, 0xa9, 0x99, 0x00, 0x60, 0x08, 0xb0, 0x5a, 0xa7)
//{d2d85db4-840f-49b8-9982-07d2405ec6b7}
DEFINE_GUID (IID_IOSTX, 0xd2d85db4, 0x840f, 0x49b8, 0x99, 0x82, 0x07, 0xd2, 0x40, 0x5e, 0xc6, 0xb7)
Use los dos siguientes identificadores de interfaz con IMAPIContainer::OpenEntry, IMAPISession::OpenEntry, o IMsgStore::OpenEntry para abrir e ignorar cualquier comprobación de proveedor en un objeto de carpeta y un objeto de mensaje, respectivamente.
//{57D333A0-F589-4b23-A3F9-85F82FEC153C}
DEFINE_GUID (IID_IMAPIFolderNoProvChk, 0x57D333A0, 0xF589, 0x4b23, 0xA3, 0xF9, 0x85, 0xF8, 0x2F, 0xEC, 0x15, 0x3C)
//{C3505457-7B2E-4c3b-A8D6-6DD949BB97A1}
DEFINE_GUID (IID_IMessageNoProvChk, 0xC3505457, 0x7B2E, 0x4c3b, 0xA8, 0xD6, 0x6D, 0xD9, 0x49, 0xBB, 0x97, 0xA1)
Almacén de MAPI
Esta sección contiene las definiciones de constantes y los identificadores de interfaz utilizados por API que interactúan con un almacén MAPI.
| Constante | Definición | Descripción |
|---|---|---|
| fnevIndexing |
((ULONG) 0x00010000) |
Un proveedor de almacén puede especificar fnevIndexing en el miembro ulEventType de la estructura NOTIFICATION para notificar al indizador que un objeto está listo para su indexación. El miembro información de la estructura notificación contiene una estructura EXTENDED_NOTIFICATION. |
| FS_NONE |
0x00 |
Un cliente puede llamar a IFolderSupport::GetSupportMask y buscar la máscara de bits devuelta. FS_NONE indica que la carpeta no admite el uso compartido. |
| FS_SUPPORTS_SHARING |
0x01 |
Un cliente puede llamar a IFolderSupport::GetSupportMask y buscar la máscara de bits devuelta. FS_SUPPORTS_SHARING indica que la carpeta admite el uso compartido. |
| INDEXING_SEARCH_OWNER |
((ULONG) 0x00000001) |
Identifica el proceso que está enviando una notificación a un indizador de que un objeto está listo para su indexación. |
| MNID_ID |
Según se define en el archivo de encabezado winerror.h del Kit de desarrollo de Software (SDK) de Microsoft Windows |
Un valor para el campo ulKind de la estructura MAPINAMEID. |
| MNID_STRING |
Según se define en el archivo de encabezado winerror.h del Kit de desarrollo de Software (SDK) de Microsoft Windows. | Un valor para el campo ulKind de la estructura MAPINAMEID. |
| MSCAP_RES_ANNOTATION |
((ULONG) 0x00000001) |
Si un cliente especifica MSCAP_SEL_RESTRICTION en mscapSelector para IMSCapabilities::GetCapabilities, GetCapabilities puede devolver este valor si el almacén omite parámetros no válidos en una restricción. |
| MSCAP_SECURE_FOLDER_HOMEPAGES |
((ULONG) 0x00000001) |
Si un cliente especifica MSCAP_SEL_FOLDER en mscapSelector para IMSCapabilities::GetCapabilities, GetCapabilities puede devolver este valor si el almacén es un almacén no predeterminado que admite páginas principales de carpeta. |
| STORE_PUSHER_OK |
((ULONG) 0x00800000) |
Un cliente puede obtener la propiedad PR_SUPPORT_MASK para determinar la característica de un almacén de mensajes. Si el proveedor del almacén establece la marca STORE_PUSHER_OK en la máscara de bits, significa que el controlador de protocolo MAPI no rastreará el almacén, y el almacén es responsable de enviar cualquier cambio a través de notificaciones al indizador para que los mensajes sean indexados. |
Definiciones de espacios de nombres
Los siguientes identificadores únicos globales (GUID) representan los espacios de nombres de las propiedades con nombre. Están indexados por el controlador de protocolo (PH) MAPI y se documentan como de solo lectura.
Precaución
Las propiedades con nombre no deben usarse para crear o modificar elementos.
const GUID PS_INTERNET_HEADERS = {0x00020386, 0x0000, 0x0000, {0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46}};
const GUID PS_PUBLIC_STRINGS = {0x00020329, 0x0000, 0x0000, {0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46}};
const GUID PSETID_Address = {0x00062004, 0x0000, 0x0000, {0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46}};
const GUID PSETID_Appointment = {0x00062002, 0x0000, 0x0000, {0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46}};
const GUID PSETID_Common = {0x00062008, 0x0000, 0x0000, {0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46}};
const GUID PSETID_Log = {0x0006200A, 0x0000, 0x0000, {0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46}};
const GUID PSETID_Meeting = {0x6ED8DA90, 0x450B, 0x101B, {0x98, 0xDA, 0x00, 0xAA, 0x00, 0x3F, 0x13, 0x05}};
const GUID PSETID_Task = {0x00062003, 0x0000, 0x0000, {0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x46}};
Propiedades MNID_ID
// In PSETID_Address
#define dispidWorkAddressStreet 0x8045
#define dispidWorkAddressCity 0x8046
#define dispidWorkAddressState 0x8047
#define dispidWorkAddressPostalCode 0x8048
#define dispidWorkAddressCountry 0x8049
#define dispidInstMsg 0x8062
#define dispidEmailDisplayName 0x8080
#define dispidEmailOriginalDisplayName 0x8084
// In PSETID_Appointment
#define dispidLocation 0x8208
#define dispidApptStartWhole 0x820D
#define dispidApptEndWhole 0x820E
#define dispidApptDuration 0x8213
#define dispidRecurring 0x8223
#define dispidAllAttendeesString 0x8238
#define dispidToAttendeesString 0x823B
#define dispidCCAttendeesString 0x823C
// In PSETID_Common
#define dispidReminderSet 0x8503
#define dispidSmartNoAttach 0x8514
#define dispidCommonStart 0x8516
#define dispidCommonEnd 0x8517
#define dispidRequest 0x8530
#define dispidCompanies 0x8539
#define dispidReminderNextTime 0x8560
// In PSETID_Log (also known as Journal)
#define dispidLogType 0x8700
#define dispidLogStart 0x8706
#define dispidLogDuration 0x8707
#define dispidLogEnd 0x8708MNID_STRING properties
// In PSETID_Task
#define dispidTaskStartDate 0x8104
#define dispidTaskDueDate 0x8105
#define dispidTaskActualEffort 0x8110
#define dispidTaskEstimatedEffort 0x8111
#define dispidTaskFRecur 0x8126
Propiedades MNID_STRING
// In PS_PUBLIC_STRINGS
"Keywords"
// In PS_INTERNET_HEADERS
"return-path"
Identificadores de interfaz
//{00375ac3-ecaf-4ef8-a527-34f452fa9c67}
DEFINE_GUID(IID_IFolderSupport, 0x00375ac3, 0xecaf, 0x4ef8, 0xa5, 0x27, 0x34, 0xf4, 0x52, 0xfa, 0x9c, 0x67);
//{29F3AB10-554d-11d0-a97c-00a0c911f50a}
#define DEFINE_PRXGUID(_name, _l) DEFINE_GUID(_name, (0x29f3ab10 + _l), 0x554d, 0x11d0, 0xa9, 0x7c, 0x00, 0xa0, 0xc9, 0x11, 0xf5, 0x0a)
DEFINE_PRXGUID(IID_IProxyStoreObject, 0x00000000L);
Use la DEFINE_OLEGUID macro definida en el archivo de encabezado Windows SDK guiddef.h para asociar el siguiente nombre simbólico GUID con su valor.
//{00020393-0000-0000-C000-000000000046}
DEFINE_OLEGUID(IID_IMSCapabilities, 0x00020393, 0, 0)
Constantes de libreta de direcciones MAPI
Esta sección contiene las definiciones de constantes de la libreta de direcciones MAPI.
| Constante | Definición | Descripción |
|---|---|---|
| CONTAB_ROOT |
((ULONG) 0x00000001) |
La carpeta raíz de un objeto de libreta de direcciones MAPI. |
| CONTAB_SUBROOT |
((ULONG) 0x00000002) |
Una subcarpeta incluida en la carpeta raíz del objeto de la libreta de direcciones MAPI. |
| CONTAB_CONTAINER |
((ULONG) 0x00000003) |
Un objeto contenedor de libreta de direcciones. |
| CONTAB_USER |
((ULONG) 0x00000004) |
Un objeto de usuario de mensajería. |
| CONTAB_DISTLIST |
((ULONG) 0x00000005) |
Un objeto de la lista de distribución. |
Constantes MAPI adicionales
Esta sección contiene las definiciones de constantes que incluyen códigos de error y los identificadores de interfaz usados por la API de MAPI que no se han expuesto y documentado previamente.
| Constante | Definición | Descripción |
|---|---|---|
| DIALOG_MODAL |
((ULONG) 0x00000001) |
Cuando un cliente llama al método IAddrBook::D etails , el cliente debe establecer la marca DIALOG_MODAL en el parámetro ulFlags para mostrar el cuadro de diálogo modal que muestra los detalles sobre una entrada de libreta de direcciones determinada. Esta constante se define en mapidefs.h. |
| ITEMPROC_FORCE |
0x00000800 |
En Outlook 2007, los almacenes de archivos PST ajustados procesan los nuevos mensajes con filtros de spam y reglas antes de que se notifique a los clientes de MAPI de los mensajes nuevos. Un proveedor o cliente que use el método IMAPIFolder::CreateMessage para crear un nuevo mensaje en almacenes PST debe establecer la marca de ITEMPROC_FORCE en el parámetro ulFlags del método IMAPIProp::SaveChanges para indicar al almacén PST que el mensaje es apto para el procesamiento de reglas antes de que el almacén notifique a cualquier cliente de escucha la llegada del nuevo mensaje. Tenga en cuenta que dichas reglas de procesamiento solo se aplican a los nuevos mensajes creados en un servidor que no sea un Microsoft Exchange Server, ya que Exchange Server procesa las reglas para los mensajes en el servidor. Por lo tanto, el proveedor o cliente que crea un mensaje debe pasar este indicador junto con NON_EMS_XP_SAVE, lo que indica que el servidor no es un servidor de Exchange. |
| MAPI_BG_SESSION |
0x00200000 |
Un cliente puede llamar a la función MAPILogonEx , estableciendo la marca MAPI_BG_SESSION en el parámetro flFlags para iniciar sesión en una sesión y realizar cualquier operación en segundo plano. En general, si un cliente pretende realizar procesamiento en un subproceso en segundo plano o en un proceso independiente de manera que no altere el subproceso de primer plano, debe llamar a MAPILogonEx con la marca MAPI_BG_SESSION. Un ejemplo en el que se utiliza es una aplicación de cliente, como un motor de indexación, que abre un archivo de carpetas personales (PST) para un acceso de fondo. |
| MAPI_CACHE_ONLY |
0x00004000 |
Un cliente puede llamar al método IAddrBook::OpenEntry , estableciendo la marca MAPI_CACHE_ONLY en el parámetro ulFlags para abrir una entrada de la libreta de direcciones y acceder a ella posteriormente solo desde la memoria caché. Un ejemplo en el que se utiliza es una aplicación de cliente que quiere abrir la lista global de direcciones en el modo caché de Exchange y obtener acceso a una entrada de esa libreta de direcciones de la memoria caché sin crear tráfico entre el cliente y el servidor. |
| MAPI_DIALOG_MODELESS |
0x0000000C |
Este valor se puede pasar a la función MAPISendMail simple en el parámetro ulFlags para especificar que la aplicación de correo predeterminada muestra un cuadro de diálogo modeless. Si no se establecen ni este indicador ni MAPI_DIALOG (0 x 00000008), no se mostrará ningún cuadro de diálogo. |
| MAPI_NO_CACHE |
0x00000200 |
Si Microsoft Office Outlook está en modo de intercambio almacenado en caché y se ha abierto un almacén en modo almacenado en caché, un cliente o proveedor de servicios puede llamar a IMsgStore::OpenEntry, estableciendo la marca MAPI_NO_CACHE en el parámetro ulFlags para abrir un elemento o una carpeta en el almacén remoto. Tenga en cuenta que, si abre el almacén de mensajes con la marca MDB_ONLINE en el servidor remoto, no tiene que usar la marca MAPI_NO_CACHE. |
| MAPI_UNICODE |
0x80000000 |
Un cliente o proveedor de servicios puede llamar a la función OpenIMsgOnIStg y establecer la marca de MAPI_UNICODE en el parámetro ulFlags para crear archivos de .msg Unicode. El archivo IMessage: IMAPIProp resultante muestra STORE_UNICODE_OK en su Propiedad canónica PidTagStoreSupportMask y es compatible con propiedades Unicode. Esta constante se define en mapidefs.h. |
| MDB_ONLINE |
0x00000100 |
Si Outlook está en modo de intercambio almacenado en caché, un cliente o proveedor de servicios puede llamar al método IMAPISession::OpenMsgStore , estableciendo la marca MDB_ONLINE en el parámetro ulFlags para invalidar la conexión al almacén de mensajes local y abrir el almacén en el servidor remoto. Tenga en cuenta que no puede abrir un almacén de Exchange en el modo caché y en modo sin caché al mismo tiempo en la misma sesión MAPI. Si ya ha abierto el almacén de mensajes en modo caché, debe cerrar el almacén antes de abrirlo con esta marca o abrir una nueva sesión MAPI donde puede abrir el almacén de Exchange en el servidor remoto mediante este marcador. |
| NON_EMS_XP_SAVE |
0x00001000 |
Un cliente puede llamar al método IMAPIProp::SaveChanges , estableciendo la marca NON_EMS_XP_SAVE en el parámetro ulFlags para indicar que el mensaje no se ha entregado desde un servidor exchange. Esta marca debe usarse en combinación con la marca ITEMPROC_FORCE en el parámetro ulFlags para indicar a un almacén PST que el mensaje es apto para el procesamiento de reglas antes de que el almacén PST notifique a cualquier cliente de escucha la llegada del mensaje. Esto reglas de procesamiento solo se aplican a los nuevos mensajes creados con IMAPIFolder::CreateMessage en un servidor que no es un servidor de Exchange (en cuyo caso el servidor Exchange ya habría procesado reglas en el mensaje). |
| SPAMFILTER_ONSAVE |
0x00000080 |
Un cliente puede llamar a IMAPIProp::SaveChanges, estableciendo la marca SPAMFILTER_ONSAVE en el parámetro ulFlags para habilitar el filtrado de correo no deseado en un mensaje que se está guardando. El soporte de filtrado de spam solo está disponible si el tipo de dirección de correo electrónico del remitente es Protocolo simple de transferencia de correo (SMTP) y el mensaje se está guardando en un almacén de un archivo de carpetas personales (PST). |
| STORE_ITEMPROC |
0x00200000 |
Si se establece esta marca en la Propiedad canónica PidTagStoreSupportMask de un almacén de archivos PST ajustado, indica que cuando llega un mensaje nuevo al almacén, el almacén procesa reglas y filtrado antispam del mensaje por separado. A continuación el almacén llama a IMAPISupport::Notify, configurando fnevNewMail en la estructura notificación estructura que se pasa como un parámetro y pasando los detalles del nuevo mensaje a un cliente en escucha. Posteriormente, cuando el cliente en escucha recibe la notificación, no procesa las reglas en el mensaje. |
| STORE_UNICODE_OK |
0x00040000 |
Si esta marca se incluye en la Propiedad canónica PidTagStoreSupportMask, indica que el almacén admite almacenamiento Unicode. Un cliente puede buscar la presencia de la marca para decidir si desea solicitar o guardar información Unicode en el almacén. |
Definiciones para archivar elementos en una carpeta
Las siguientes definiciones de constantes son valores que se usan para configurar la Propiedad canónica PidTagAgingGranularity.
#define AG_MONTHS 0
#define AG_WEEKS 1
#define AG_DAYS 2
Definiciones para mostrar objetos remotos
Las definiciones de macros y constantes siguientes son para mostrar los objetos remotos. Para obtener más información, vea la Propiedad canónica PidTagDisplayTypeEx.
#define DTE_FLAG_REMOTE_VALID0x80000000
#define DTE_FLAG_ACL_CAPABLE 0x40000000
#define DTE_MASK_REMOTE 0x0000ff00
#define DTE_MASK_LOCAL 0x000000ff
#define DTE_IS_REMOTE_VALID(v)(!!((v) & DTE_FLAG_REMOTE_VALID))
#define DTE_IS_ACL_CAPABLE(v)(!!((v) & DTE_FLAG_ACL_CAPABLE))
#define DTE_REMOTE(v)(((v) & DTE_MASK_REMOTE) >> 8)
#define DTE_LOCAL(v)((v) & DTE_MASK_LOCAL)
#define DT_ROOM((ULONG) 0x00000007)
#define DT_EQUIPMENT((ULONG) 0x00000008)
#define DT_SEC_DISTLIST((ULONG) 0x00000009)
Definiciones de libreta de direcciones de Exchange y códigos de error del almacén de mensajes
A continuación se muestran las definiciones de códigos de error de la libreta de direcciones de Exchange y el almacén de mensajes, que tienen capacidad de reconexión. La última llamada a un catálogo global (GC) desconectado puede dar como resultado el error MAPI_E_END_OF_SESSION, que debería volverse a intentar.
MAPI de Outlook es compatible con la reconexión a un servidor de catálogo global sin reconfiguración especial, pero puede que se devuelvan otros códigos de error al cliente.
| Constante | Definición | Descripción |
|---|---|---|
| MAPI_E_END_OF_SESSION |
0x80040200 |
Se devuelve cuando se ha desconectado una conexión. |
| MAPI_E_RECONNECTED |
0x80040125 |
Se devuelve cuando el token de conexión de llamada a procedimiento remoto (RPC) no está actualizado. Si el token de la transacción actual es diferente del token de la conexión que significa que se ha vuelto a conectar, se devuelve MAPI_E_RECONNECTEDy se puede tratar igualque MAPI_E_END_OF_SESSION. Debería volver a intentar la llamada. |
| MAPI_E_OFFLINE |
0x80040126 |
Se devuelve cuando la conexión está desconectada. Normalmente, esto significa que ha ocurrido algo en el entorno, como errores en el servidor o pérdida de conectividad de red. Es más probable que aparezca este error al usar el modo caché de un perfil e intenta evitar la caché para comunicarse con el servidor. Si la caché no pudo inicialmente establecer una conexión con el servidor, puede que esté en el estado sin conexión en el que MAPI_E_OFFLINE puede aparecer. |
Ninguno de los dos errores anteriores se devolverán en todos los escenarios donde parece probable que se aplicasen. En la mayoría de los casos, se devolverán MAPI_E_NETWORK_ERROR o MAPI_E_CALL_FAILED . Ninguno aparecerá al usar la descarga de Microsoft Exchange Server MAPI Client and Collaboration Data Objects 1.2.1.
Definiciones para las cuotas del modo de almacenamiento en caché del buzón de correo Exchange Server
Las siguientes definiciones de constantes son usadas por Microsoft Outlook 2010 y Microsoft Outlook 2013 para configurar las cuotas del perfil en modo caché de Exchange que son equivalentes a las cuotas de buzón de Exchange que, en caso contrario, sólo están disponibles con un perfil en línea.
#define PR_QUOTA_WARNING PROP_TAG( PT_LONG, 0x341A)
#define PR_QUOTA_SEND PROP_TAG( PT_LONG, 0x341B)
#define PR_QUOTA_RECEIVE PROP_TAG( PT_LONG, 0x341C)
Estas propiedades se asignan a sus propiedades en línea correspondientes y contienen los mismos valores en kilobytes. PR_QUOTA_WARNING se asigna a PR_STORAGE_QUOTA_LIMIT, PR_QUOTA_SEND a PR_QUOTA_PROHIBIT_SEND_QUOTA y PR_QUOTA_RECEIVE a PR_PROHIBIT_RECEIVE_QUOTA.
Definiciones de formato del mensaje
Las siguientes definiciones de constantes son valores que se usan para configurar la Propiedad canónica PidTagMessageEditorFormat.
#define EDITOR_FORMAT_DONTKNOW ((ULONG) 0)
#define EDITOR_FORMAT_PLAINTEXT ((ULONG) 1)
#define EDITOR_FORMAT_HTML ((ULONG) 2)
#define EDITOR_FORMAT_RTF ((ULONG) 3)
Definiciones para usar RPC a través de HTTP
Consulte el tema Propiedad canónica PidTagRpcOverHttpFlags para obtener definiciones de constantes usadas como marcas para establecer la propiedad.
Consulte el tema Propiedad canónica PidTagRpcOverHttpProxyAuthScheme para obtener definiciones de constantes usadas para establecer la propiedad.
Identificadores
Use la DEFINE_OLEGUID macro definida en el archivo de encabezado guiddef.h del archivo de encabezado de Microsoft Kit de desarrollo de software de Windows (SDK) para asociar los siguientes nombres simbólicos GUID a sus valores.
//{0002038A-0000-0000-C000-000000000046}
#if !defined(INITGUID) || defined(USES_IID_IMessageRaw)
DEFINE_OLEGUID(IID_IMessageRaw,0x0002038A, 0, 0);
#endif
El siguiente identificador es para la sección de perfil Capone de una libreta de direcciones, que como apoyo a buzones múltiples de Exchange (MultiEx) contiene una propiedad PR_AB_CHOOSE_DIRECTORY_AUTOMATICALLY que desactiva de forma efectiva el contenedor predeterminado especificado por SetDefaultDir.
// {00020D0A-0000-0000-C000-000000000046}
DEFINE_OLEGUID(IID_CAPONE_PROF, 0x00020d0a, 0, 0);
Identificadores de interfaz
IMAPISync
DEFINE_GUID(IID_IMAPISync, 0x5024a385, 0x2d44, 0x486a, 0x81, 0xa8, 0x8f, 0xe, 0xcb, 0x60, 0x71, 0xdd);
IMAPISyncProgressCallback
DEFINE_GUID(IID_IMAPISyncProgressCallback, 0x5024a386, 0x2d44, 0x486a, 0x81, 0xa8, 0x8f, 0xe, 0xcb, 0x60, 0x71, 0xdd);
IID_IContabAdmin
// {CC6A3BA9-E7F5-4769-887B-34E190817BFC}
DEFINE_GUID(IID_IContabAdmin, 0xcc6a3ba9, 0xe7f5, 0x4769, 0x88, 0x7b, 0x34, 0xe1, 0x90, 0x81, 0x7b, 0xfc);
IID_IMAPISECUREMESSAGE
DEFINE_GUID(IID_IMAPISecureMessage, 0x253cc320, 0xeab6, 0x11d0, 0x82, 0x22, 0, 0x60, 0x97, 0x93, 0x87, 0xea);
IID_IMAPIGetSession
DEFINE_GUID(IID_IMAPIGetSession, 0x614ab435, 0x491d, 0x4f5b, 0xa8, 0xb4, 0x60, 0xeb, 0x3, 0x10, 0x30, 0xc6);
Identificadores de interfaz del controlador de invalidación PST
IID_IPSTOVERRIDEREQ
// {892EBC6D-24DC-4d90-BA48-C6CBEC14A86A}
DEFINE_GUID(IID_IPSTOVERRIDEREQ, 0x892ebc6d, 0x24dc, 0x4d90, 0xba, 0x48, 0xc6, 0xcb, 0xec, 0x14, 0xa8, 0x6a);
IID_IPSTOVERRIDE1
// {FBB68D34-F561-44fb-A8CA-AE36696342CA}
DEFINE_GUID(IID_IPSTOVERRIDE1, 0xfbb68d34, 0xf561, 0x44fb, 0xa8, 0xca, 0xae, 0x36, 0x69, 0x63, 0x42, 0xca);
Vea también
- Acerca de las adiciones de MAPI
- Acerca de las propiedades con nombre que usa Outlook
- Acceder a un almacén en el servidor remoto cuando Outlook está en modo caché de Exchange
- Abrir un almacén en el servidor remoto cuando Outlook está en modo caché de Exchange
- Administrar un mensaje en un OST sin invocar una sincronización en el modo de intercambio en caché