Constantes de MAPI
Aplica-se a: Outlook 2013 | Outlook 2016
Esse tópico contém constantes declarações de interface MAPI e identificadores de classe e interface usados pelo APIs MAPI.
Identificadores de classe e interface
Use a macro DEFINE_GUID estipulada no Microsoft Windows Software Development Kit (SDK do Windows) no arquivo cabeçalho guiddef.h para associar os nomes dos simbólico de identificador global exclusivo (GUID) com seus valores, a menos que indicado de outra forma.
API de conversão de segurança de anexos
Esta seção contém definições constantes e identificadores interface para a API de segurança de anexos.
// {b2533636-c3f3-416f-bf04-aefe41abaae2}
DEFINE_GUID(IID_IAttachmentSecurity, 0xb2533636, 0xc3f3, 0x416f, 0xbf, 0x04, 0xae, 0xfe, 0x41, 0xab, 0xaa, 0xe2);
Use a macro MAPIMETHOD estipulada no arquivo cabeçalho mapidefs.h do SDK do Windows* para definir a função virtual pura IsAttachmentBlocked.
#define MAPI_IATTACHMENTSECURITY_METHODS(IPURE) MAPIMETHOD(IsAttachmentBlocked) (LPCWSTR pwszFileName, BOOL *pfBlocked) IPURE;
Usar a macro DECLARE_MAPI_INTERFACE_ estipulada a no arquivo cabeçalho mapidefs.h do SDK do Windows* para definir a tabela virtual método IAttachmentSecurity.
DECLARE_MAPI_INTERFACE_(IAttachmentSecurity, IUnknown)
{
BEGIN_INTERFACE
MAPI_IUNKNOWN_METHODS(PURE)
MAPI_IATTACHMENTSECURITY_METHODS(PURE)
};
Sobre a API de conversão MAPI-MIME
Esta seção contém definições constantes e identificadores de classe e interface para a API de conversão de MAPI MIME.
Constant | Definição |
---|---|
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 |
Conforme definido no arquivo cabeçalho winerror.h do Microsoft Software Development Kit do Windows (SDK do Windows) |
Identificadores de classe
// {4e3a7680-b77a-11d0-9da5-00c04fd65685}
DEFINE_GUID(CLSID_IConverterSession, 0x4e3a7680, 0xb77a, 0x11d0, 0x9d, 0xa5, 0x0, 0xc0, 0x4f, 0xd6, 0x56, 0x85);
Identificadores de interface
// {4b401570-b77b-11d0-9da5-00c04fd65685}
DEFINE_GUID(IID_IConverterSession, 0x4b401570, 0xb77b, 0x11d0, 0x9d, 0xa5, 0x0, 0xc0, 0x4f, 0xd6, 0x56, 0x85);
API de estado offline
Esta seção contém definições constantes e identificadores de classe e interface para o API de estado offline.
Constant | Definição |
---|---|
E_INVALIDARG |
Conforme definido no arquivo cabeçalho winerror.h do Microsoft Software Development Kit do Windows (SDK do Windows) |
E_NOINTERFACE |
Conforme definido na Winerror de arquivo do cabeçalho (SDK) do 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 |
Online ou offline |
|
MAPIOFFLINE_STATE_OFFLINE_MASK |
0x00000003 |
MAPIOFFLINE_STATE_OFFLINE |
0x00000001 |
MAPIOFFLINE_STATE_ONLINE |
0x00000002 |
Identificadores de classe
//{fbeffd93-b11f-4094-842b-96dcd31e63d1}
DEFINE_GUID(GUID_GlobalState, 0xfbeffd93, 0xb11f, 0x4094, 0x84, 0x2b, 0x96, 0xdc, 0xd3, 0x1e, 0x63, 0xd1);
Identificadores de interface
//{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);
Propriedades denominadas do Outlook
Esta seção contém definições constantes para propriedades nomeadas e suas namespaces e outras constantes relacionadas.
Definições para propriedades nomeadas:
#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
Definições de namespaces
Os seguintes identificadores globais exclusivos (GUIDs) representam os namespaces de propriedades nomeadas.
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}};
Confira a seção MAPI Store para as definições de PSETID.
Outras constantes
Constant | Definição |
---|---|
INSP_ONEOFFFLAGS |
0xD000000 |
INSP_PROPDEFINITION |
0x2000000 |
MNID_ID |
Conforme definido em mapidefs.h de arquivo o cabeçalho. |
MNID_STRING |
Conforme definido em mapidefs.h de arquivo o cabeçalho. |
mtgNone |
0x0 |
mtgRequest |
0x00000001 |
mtgFullUpdate |
0x00010000 |
mtgInfoUpdate |
0x00020000 |
mtgOutofDate |
0x00080000 |
mtgDelegated |
0x00100000 |
Replicação API
Esse tópico contém constantes declarações de interface MAPI e identificadores de classe e interface usados para a replicação do API.
A seguir uma MAPIUID estrutura para identificar um provedor de serviços MAPI:
const MAPIUID g_muidProvPrvNST =
{ 0xE9, 0x2F, 0xEB, 0x75, 0x96, 0x50, 0x44, 0x86,
0x83, 0xB8, 0x7D, 0xE5, 0x22, 0xAA, 0x49, 0x48 };
Constant | Definição |
---|---|
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 |
Declaração de interfaces
DECLARE_MAPI_INTERFACE_PTR(IExchangeImportHierarchyChanges,PXIHC);
DECLARE_MAPI_INTERFACE_PTR(IExchangeImportContentsChanges,PXICC);
Identificadores de interface
//{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 os seguintes identificadores de interface com IMAPIContainer::OpenEntry, IMAPISession::OpenEntry, ou IMsgStore::OpenEntry para abrir e ignorar qualquer verificação de provedor em objeto de pasta e objeto uma mensagem, 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)
Armazenamento de MAPI
Esta seção contém definições constantes e identificadores interface usadas por APIs essa interface com o armazenamento de MAPI.
Constant | Definição | Descrição |
---|---|---|
fnevIndexing |
((ULONG) 0X00010000) |
Um provedor de armazenamento pode especificarfnevIndexing no ulEventType parte da notificação estrutura para notificar indexador Se um objeto está pronto para indexação. A estrutura do membro de informações da estrutura de NOTIFICAÇÃO contém uma estrutura de EXTENDED_NOTIFICATION. |
FS_NONE |
0x00 |
Um cliente pode chamar IFolderSupport::GetSupportMask e verificar se há uma retornada máscara de bits. FS_NONE indica que a pasta não suporta o compartilhamento. |
FS_SUPPORTS_SHARING |
0x01 |
Um cliente pode chamar IFolderSupport::GetSupportMask e verificar se há uma retornada máscara de bits. FS_SUPPORTS_SHARING indica se a pasta é compatível com compartilhamento. |
INDEXING_SEARCH_OWNER |
((ULONG) 0X00000001) |
Identifica o processo que está fazendo com que uma notificação para um indexador um objeto esteja pronta para indexação. |
MNID_ID |
Conforme definido no arquivo cabeçalho mapidefs.h Kit de desenvolvimento em Microsoft Software Development Kit do Windows (SDK do Windows)*. |
Um valor para o campo uIKINDda estrutura MAPINAMEID. |
MNID_STRING |
Conforme definido no arquivo cabeçalho mapidefs.h do Microsoft Software Development Kit do Windows (SDK do Windows). | Um valor para o campo uIKINDda estrutura MAPINAMEID. |
MSCAP_RES_ANNOTATION |
((ULONG) 0X00000001) |
Se um cliente especificar MSCAP_SEL_RESTRICTION no mscapSelector para IMSCapabilities::GetCapabilities, GetCapabilities poderá retornar esse valor se o repositório ignorar parâmetros inválidos em uma restrição. |
MSCAP_SECURE_FOLDER_HOMEPAGES |
((ULONG) 0X00000001) |
Se um cliente especificar MSCAP_SEL_FOLDER no mscapSelector para IMSCapabilities::GetCapabilities, GetCapabilities poderá retornar esse valor se o repositório for um repositório não padrão que dê suporte a páginas inicial da pasta. |
STORE_PUSHER_OK |
((ULONG) 0X00800000) |
Um cliente pode chegar à propriedade PR_SUPPORT_MASK para determinar as características de um repositório de mensagem. Se o provedor de armazenamento definir STORE_PUSHER_OK como sinalizador em máscara de bit, significa que o identificador de protocolo MAPI não irá rastrear o armazenamento e o armazenamento é responsável por enviar quaisquer alterações através das notificações para o indexador e enviar mensagens indexadas. |
Definições de namespaces
Os seguintes identificadores globais exclusivos (GUIDs) representam os namespaces das propriedades nomeadas. Eles são indexados pelo protocolo identificador MAPI (PH) e documentados como somente leitura.
Cuidado
As propriedades nomeadas não devem ser usadas para criar ou modificar itens.
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}};
Propriedades do 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
Propriedades do MNID_STRING
// In PS_PUBLIC_STRINGS
"Keywords"
// In PS_INTERNET_HEADERS
"return-path"
Identificadores de interface
//{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 a DEFINE_OLEGUID
macro definida no guiddef.h do arquivo de cabeçalho SDK do Windows para associar o nome simbólico GUID a seguir ao seu valor.
//{00020393-0000-0000-C000-000000000046}
DEFINE_OLEGUID(IID_IMSCapabilities, 0x00020393, 0, 0)
Constantes de catálogo de endereços MAPI
Esta seção contém definições constantes para o catálogo de endereços MAPI.
Constant | Definição | Descrição |
---|---|---|
CONTAB_ROOT |
((ULONG) 0X00000001) |
Pasta raiz para um objeto de catálogos de endereços MAPI. |
CONTAB_SUBROOT |
((ULONG) 0X00000002) |
Uma subpasta contida na pasta raiz do objeto de catálogos de endereços MAPI. |
CONTAB_CONTAINER |
((ULONG) 0X00000003) |
Abrir o contêiner de um objeto do catálogo de endereços. |
CONTAB_USER |
((ULONG) 0X00000004) |
Um objeto de usuário de mensagens. |
CONTAB_DISTLIST |
((ULONG) 0X00000005) |
0" não é um objeto de lista de distribuição. |
Constantes de MAPI adicionais
Esta seção contém constantes definições, como códigos de erro e identificadores de interface usados pelo APIs MAPI não expostos e documentados anteriormente.
Constant | Definição | Descrição |
---|---|---|
DIALOG_MODAL |
((ULONG) 0X00000001) |
Quando um cliente chama o método IAddrBook::D etails , o cliente deve definir o sinalizador DIALOG_MODAL no parâmetro ulFlags para exibir a caixa de diálogo modal mostrando os detalhes sobre uma entrada específica do catálogo de endereços. Essa constante é definida em mapidefs.h. |
ITEMPROC_FORCE |
0x00000800 |
No Outlook 2007, repositório Wrapped PST ajustados tem regras e filtragem de spam processadas em novas mensagens antes de serem notificados clientes MAPI de novas mensagens. Um provedor ou cliente usando o método IMAPIFolder::CreateMessage para criar uma nova mensagem nos repositórios PST deve definir o sinalizador ITEMPROC_FORCE no parâmetro ulFlags do método IMAPIProp::SaveChanges para indicar ao repositório PST que a mensagem é qualificada para processamento de regras antes que o repositório notifique qualquer cliente ouvinte da chegada da nova mensagem. Observe que essas regras de processamento só se aplicam às novas mensagens criadas em um servidor Microsoft Exchange Server, porque o servidor Exchange processa as regras para mensagens no servidor. Longo o provedor ou cliente que criar a mensagem deve passar esse sinalizador em combinação com NON_EMS_XP_SAVE, que indica que o servidor não é um servidor do Exchange. |
MAPI_BG_SESSION |
0x00200000 |
Um cliente pode chamar a função MAPILogonEx , definindo o sinalizador MAPI_BG_SESSION no parâmetro flFlags para fazer logon em uma sessão e realizar todas as operações em segundo plano. Em geral, se um cliente pretende fazer o processamento em uma conversa de tela de fundo ou em um processo separado em uma forma que seja a conversa do primeiro plano seja discreta, ele deve acionar MAPILogonEx com o sinalizadorMAPI_BG_SESSION. Um exemplo em que isso é usado é um aplicativo do cliente, assim como um mecanismo de indexação, abrindo um arquivo de pastas particulares (PST) para o acesso de tipo plano de fundo. |
MAPI_CACHE_ONLY |
0x00004000 |
Um cliente pode chamar o método IAddrBook::OpenEntry , definindo o sinalizador MAPI_CACHE_ONLY no parâmetro ulFlags para abrir uma entrada do catálogo de endereços e acessá-lo posteriormente apenas do cache. Um exemplo em que isso é usado é um aplicativo do cliente, que deseja abrir a lista de endereços Global no modo cache do Exchange, acessar uma entrada de catálogo de endereços do cache sem criar tráfego entre o cliente e servidor. |
MAPI_DIALOG_MODELESS |
0x0000000C |
Esse valor pode ser passado para a função MAPI MAPISendMail simples no parâmetro ulFlags para especificar se uma caixa de diálogo modeless é exibida pelo aplicativo de email padrão. Se nem esse sinalizador nem o MAPI_DIALOG (0x00000008) estiverem definidos, a caixa de diálogo não é exibida. |
MAPI_NO_CACHE |
0x00000200 |
Se o Microsoft Office Outlook estiver no Modo exchange armazenado em cache e uma loja tiver sido aberta no modo armazenado em cache, um cliente ou provedor de serviços poderá chamar IMsgStore::OpenEntry, definindo o sinalizador MAPI_NO_CACHE no parâmetro ulFlags para abrir um item ou uma pasta no repositório remoto. Observe que, se você abrir o armazenamento de mensagens com o sinalizador MDB_ONLINE no servidor remoto não será necessário usar o sinalizadorMAPI_NO_CACHE. |
MAPI_UNICODE |
0x80000000 |
Um cliente ou provedor de serviços pode chamar a função OpenIMsgOnIStg , definindo o sinalizador MAPI_UNICODE no parâmetro ulFlags para criar arquivos unicode .msg. O arquivo resultante IMessage: IMAPIProp mostra STORE_UNICODE_OK na sua propriedade Canonical PidTagStoreSupportMask e é compatível com propriedades Unicode. Essa constante é definida em mapidefs.h. |
MDB_ONLINE |
0x00000100 |
Se o Outlook estiver no Modo exchange armazenado em cache, um cliente ou provedor de serviços poderá chamar o método IMAPISession::OpenMsgStore , definindo o sinalizador MDB_ONLINE no parâmetro ulFlags para substituir a conexão com o repositório de mensagens local e abrir o repositório no servidor remoto. Observe que você não pode abrir um repositório do Exchange no modo de cache e no modo em não-cache ao mesmo tempo na mesma sessão MAPI. Se você já tiver aberto o arquivo de cache mensagens, você deve fechar o repositório antes de abri-lo com esse sinalizador ou abrir uma nova sessão MAPI onde você pode abrir o armazenamento do Exchange no servidor remoto usando esse sinalizador. |
NON_EMS_XP_SAVE |
0x00001000 |
Um cliente pode chamar o método IMAPIProp::SaveChanges , definindo o sinalizador NON_EMS_XP_SAVE no parâmetro ulFlags para indicar que a mensagem não foi entregue de um servidor exchange. Esse sinalizador deve ser usado em combinação com o sinalizador ITEMPROC_FORCE no parâmetro ulFlags para indicar a um repositório PST que a mensagem é qualificada para processamento de regras antes que o repositório PST notifique qualquer cliente ouvinte da chegada da mensagem. Essas regras de processamento só se aplicam às novas mensagens que são criadas com IMAPIFolder::CreateMessage em um servidor que não é um servidor do Exchange (nesse caso o servidor Exchange já teria regras processadas na mensagem). |
SPAMFILTER_ONSAVE |
0x00000080 |
Um cliente pode chamar IMAPIProp::SaveChanges, definindo o sinalizador SPAMFILTER_ONSAVE no parâmetro ulFlags para habilitar a filtragem de spam em uma mensagem que está sendo salva. O suporte à filtragem de spam está disponível somente se o tipo de endereço de email do remetente for SMTP(Simple Mail Transfer Protocol) e a mensagem estiver sendo salva em um repositório de um arquivo de pastas particulares (PST). |
STORE_ITEMPROC |
0x00200000 |
Se esse sinalizador estiver definido na propriedade Canonical PidTagStoreSupportMask de um repositório de PST isso indica que, quando chegar uma nova mensagem no repositório, repositório tem regras e filtragem de spam processadas na mensagem separadamente. O repositório chama a configuração IMAPISupport::NotifyemfnevNewMail na notificaçãoestrutura que é autenticada como um parâmetro e passando os detalhes do novo mensagem para o cliente de escuta. Posteriormente, quando o cliente de escutará recebe a notificação, ele não processará regras na mensagem. |
STORE_UNICODE_OK |
0x00040000 |
Se esse sinalizador estiver incluído na propriedade Canonical PidTagStoreSupportMask, isso indica o repositório compatível com o armazenamento Unicode. Um cliente pode pesquisar a presença de sinalizador para decidir se vai solicitar ou salvar informações do Unicode no repositório. |
Definições para arquivar itens em uma pasta
As seguintes definições constantes são valores usados para configurar a propriedade Canonical PidTagAgingGranularity.
#define AG_MONTHS 0
#define AG_WEEKS 1
#define AG_DAYS 2
Definições para exibir objetos remotos
As seguintes definições de constante e macro são para exibir objetos remotos. Para saber mais, confira a propriedade Canonical 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)
As definições de catálogo de endereços do Exchange e mensagem armazenam códigos de erro
Estas são as definições de código de erro para o catálogo de endereços do Exchange e o Message Store, que possui o recurso reconexão. Última chamada para um catálogo global desconectado pode resultar no erro MAPI_E_END_OF_SESSION e precisará ser repetida.
O MAPI do Outlook aceita reconexão em um servidor GC sem uma reconfiguração especial, mas alguns códigos de erro podem ser retornados para o cliente.
Constant | Definição | Descrição |
---|---|---|
MAPI_E_END_OF_SESSION |
0x80040200 |
Retornado quando uma conexão tiver sido desconectada. |
MAPI_E_RECONNECTED |
0x80040125 |
Retornado quando o token de conexão do procedimento remoto (RPC) estiver desatualizado. Se o token da transação atual for diferente do token da conexão, isso significa que ele se reconectou, portanto , MAPI_E_RECONNECTEDé retornado e pode ser tratado da mesmaforma que MAPI_E_END_OF_SESSION. A chamada deve ser repetida. |
MAPI_E_OFFLINE |
0x80040126 |
Retornado quando a conexão está offline. Normalmente, isso significa que algo ocorreu no ambiente, como falha no servidor ou perda de conectividade de rede. Esse erro é mais provável que ocorra ao usar um modo cache do perfil tentando ignorar o cache de se comunicar com o servidor. Se o cache não conseguir estabelecer uma conexão com o servidor, o estado offlineMAPI_E_OFFLINE pode surgir. |
Nenhuma dos dois erros anteriores será retornado em todos os cenários onde eles poderiam ser usados. Na maioria dos casos, MAPI_E_NETWORK_ERROR ou MAPI_E_CALL_FAILED serão retornados. Nem irá aparecer usando o download do MAPI do cliente Microsoft Exchange Server e Collaboration Data Objects 1.2.1.
Definições para cotas de modo em cache para o Exchange Server Mailbox.
As seguintes definições constantes são usadas pelo Microsoft Outlook 2010 e Microsoft Outlook 2013 para configurar as cotas de perfil do Exchange de modo que são equivalentes às cotas da caixa de correio Exchange em outros casos disponíveis somente com um perfil online.
#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)
Essas propriedades mapeiam suas propriedades online correspondentes e contêm os mesmos valores em quilobytes. Mapear PR_QUOTA_WARNING para PR_STORAGE_QUOTA_LIMIT PR_QUOTA_SEND para PR_QUOTA_PROHIBIT_SEND_QUOTA e PR_QUOTA_RECEIVE para PR_PROHIBIT_RECEIVE_QUOTA.
Definições para formato da mensagem
As seguintes definições constantes são valores usados para configurar a propriedade Canonical 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)
Definições para usar RPC sobre HTTP*
Confira as propriedades Canonical das definições de tópico constante PidTagRpcOverHttpFlags usadas como sinalizadores para definir a propriedade.
Confira as propriedades Canonical das definições de tópico constante PidTagRpcOverHttpProxyAuthScheme usadas para definir a propriedade.
Identificadores
Use a DEFINE_OLEGUID
macro definida no guiddef.h do arquivo de cabeçalho do Microsoft Software Development Kit do Windows (SDK do Windows) (SDK) para associar os nomes simbólicos GUID a seguir aos seus valores.
//{0002038A-0000-0000-C000-000000000046}
#if !defined(INITGUID) || defined(USES_IID_IMessageRaw)
DEFINE_OLEGUID(IID_IMessageRaw,0x0002038A, 0, 0);
#endif
O seguinte identificador é para o perfil Capone de um catálogo de endereços, que em suporte com multiplas caixas de correio Exchange (MultiEx) contendo a propriedadePR_AB_CHOOSE_DIRECTORY_AUTOMATICALLY que efetivamente desativa o contêiner padrão especificado pelo SetDefaultDir.
// {00020D0A-0000-0000-C000-000000000046}
DEFINE_OLEGUID(IID_CAPONE_PROF, 0x00020d0a, 0, 0);
Identificadores de interface
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 interface de substituição do 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);
Confira também
- Sobre as adições de MAPI
- Sobre as propriedades nomeadas usadas pelo Outlook
- Acessar o Store em um servidor remoto quando o Outlook estiver no modo cache do Exchange
- Abrir o Store em um servidor remoto quando o Outlook estiver no modo cache do Exchange
- Gerenciar mensagens em um OST sem solicitar uma sincronização do modo cache do Exchange