windows-nt/Source/XPSP1/NT/public/sdk/inc/mapix.h
2020-09-26 16:20:57 +08:00

546 lines
17 KiB
C

/*
* M A P I X . H
*
* Definitions of objects/flags, etc used by Extended MAPI.
*
* Copyright 1986-1999 Microsoft Corporation. All Rights Reserved.
*/
#ifndef MAPIX_H
#define MAPIX_H
#if _MSC_VER > 1000
#pragma once
#endif
/* Include common MAPI header files if they haven't been already. */
#ifndef MAPIDEFS_H
#include <mapidefs.h>
#endif
#ifndef MAPICODE_H
#include <mapicode.h>
#endif
#ifndef MAPIGUID_H
#include <mapiguid.h>
#endif
#ifndef MAPITAGS_H
#include <mapitags.h>
#endif
#ifdef __cplusplus
extern "C" {
#endif
#ifndef BEGIN_INTERFACE
#define BEGIN_INTERFACE
#endif
/* Forward interface declarations */
DECLARE_MAPI_INTERFACE_PTR(IProfAdmin, LPPROFADMIN);
DECLARE_MAPI_INTERFACE_PTR(IMsgServiceAdmin, LPSERVICEADMIN);
DECLARE_MAPI_INTERFACE_PTR(IMAPISession, LPMAPISESSION);
/* ------------------------------------------------------ */
/* shared with simple mapi */
typedef ULONG FLAGS;
/* MAPILogon() flags. */
#define MAPI_LOGON_UI 0x00000001 /* Display logon UI */
#define MAPI_NEW_SESSION 0x00000002 /* Don't use shared session */
#define MAPI_ALLOW_OTHERS 0x00000008 /* Make this a shared session */
#define MAPI_EXPLICIT_PROFILE 0x00000010 /* Don't use default profile */
#define MAPI_EXTENDED 0x00000020 /* Extended MAPI Logon */
#define MAPI_FORCE_DOWNLOAD 0x00001000 /* Get new mail before return */
#define MAPI_SERVICE_UI_ALWAYS 0x00002000 /* Do logon UI in all providers */
#define MAPI_NO_MAIL 0x00008000 /* Do not activate transports */
/* #define MAPI_NT_SERVICE 0x00010000 Allow logon from an NT service */
#ifndef MAPI_PASSWORD_UI
#define MAPI_PASSWORD_UI 0x00020000 /* Display password UI only */
#endif
#define MAPI_TIMEOUT_SHORT 0x00100000 /* Minimal wait for logon resources */
#define MAPI_SIMPLE_DEFAULT (MAPI_LOGON_UI | MAPI_FORCE_DOWNLOAD | MAPI_ALLOW_OTHERS)
#define MAPI_SIMPLE_EXPLICIT (MAPI_NEW_SESSION | MAPI_FORCE_DOWNLOAD | MAPI_EXPLICIT_PROFILE)
/* Structure passed to MAPIInitialize(), and its ulFlags values */
typedef struct
{
ULONG ulVersion;
ULONG ulFlags;
} MAPIINIT_0, FAR *LPMAPIINIT_0;
typedef MAPIINIT_0 MAPIINIT;
typedef MAPIINIT FAR *LPMAPIINIT;
#define MAPI_INIT_VERSION 0
#define MAPI_MULTITHREAD_NOTIFICATIONS 0x00000001
/* Reserved for MAPI 0x40000000 */
/* #define MAPI_NT_SERVICE 0x00010000 Use from NT service */
/* MAPI base functions */
typedef HRESULT (STDAPICALLTYPE MAPIINITIALIZE)(
LPVOID lpMapiInit
);
typedef MAPIINITIALIZE FAR *LPMAPIINITIALIZE;
typedef void (STDAPICALLTYPE MAPIUNINITIALIZE)(void);
typedef MAPIUNINITIALIZE FAR *LPMAPIUNINITIALIZE;
MAPIINITIALIZE MAPIInitialize;
MAPIUNINITIALIZE MAPIUninitialize;
/* Extended MAPI Logon function */
typedef HRESULT (STDMETHODCALLTYPE MAPILOGONEX)(
ULONG_PTR ulUIParam,
LPTSTR lpszProfileName,
LPTSTR lpszPassword,
ULONG ulFlags, /* ulFlags takes all that SimpleMAPI does + MAPI_UNICODE */
LPMAPISESSION FAR * lppSession
);
typedef MAPILOGONEX FAR *LPMAPILOGONEX;
MAPILOGONEX MAPILogonEx;
typedef SCODE (STDMETHODCALLTYPE MAPIALLOCATEBUFFER)(
ULONG cbSize,
LPVOID FAR * lppBuffer
);
typedef SCODE (STDMETHODCALLTYPE MAPIALLOCATEMORE)(
ULONG cbSize,
LPVOID lpObject,
LPVOID FAR * lppBuffer
);
typedef ULONG (STDAPICALLTYPE MAPIFREEBUFFER)(
LPVOID lpBuffer
);
typedef MAPIALLOCATEBUFFER FAR *LPMAPIALLOCATEBUFFER;
typedef MAPIALLOCATEMORE FAR *LPMAPIALLOCATEMORE;
typedef MAPIFREEBUFFER FAR *LPMAPIFREEBUFFER;
MAPIALLOCATEBUFFER MAPIAllocateBuffer;
MAPIALLOCATEMORE MAPIAllocateMore;
MAPIFREEBUFFER MAPIFreeBuffer;
typedef HRESULT (STDMETHODCALLTYPE MAPIADMINPROFILES)(
ULONG ulFlags,
LPPROFADMIN FAR *lppProfAdmin
);
typedef MAPIADMINPROFILES FAR *LPMAPIADMINPROFILES;
MAPIADMINPROFILES MAPIAdminProfiles;
/* IMAPISession Interface -------------------------------------------------- */
/* Flags for OpenEntry and others */
/*#define MAPI_MODIFY ((ULONG) 0x00000001) */
/* Flags for Logoff */
#define MAPI_LOGOFF_SHARED 0x00000001 /* Close all shared sessions */
#define MAPI_LOGOFF_UI 0x00000002 /* It's OK to present UI */
/* Flags for SetDefaultStore. They are mutually exclusive. */
#define MAPI_DEFAULT_STORE 0x00000001 /* for incoming messages */
#define MAPI_SIMPLE_STORE_TEMPORARY 0x00000002 /* for simple MAPI and CMC */
#define MAPI_SIMPLE_STORE_PERMANENT 0x00000003 /* for simple MAPI and CMC */
#define MAPI_PRIMARY_STORE 0x00000004 /* Used by some clients */
#define MAPI_SECONDARY_STORE 0x00000005 /* Used by some clients */
/* Flags for ShowForm. */
#define MAPI_POST_MESSAGE 0x00000001 /* Selects post/send semantics */
#define MAPI_NEW_MESSAGE 0x00000002 /* Governs copying during submission */
/* MessageOptions */
/****** MAPI_UNICODE ((ULONG) 0x80000000) */
/* QueryDefaultMessageOpt */
/****** MAPI_UNICODE ((ULONG) 0x80000000) */
#define MAPI_IMAPISESSION_METHODS(IPURE) \
MAPIMETHOD(GetLastError) \
(THIS_ HRESULT hResult, \
ULONG ulFlags, \
LPMAPIERROR FAR * lppMAPIError) IPURE; \
MAPIMETHOD(GetMsgStoresTable) \
(THIS_ ULONG ulFlags, \
LPMAPITABLE FAR * lppTable) IPURE; \
MAPIMETHOD(OpenMsgStore) \
(THIS_ ULONG_PTR ulUIParam, \
ULONG cbEntryID, \
LPENTRYID lpEntryID, \
LPCIID lpInterface, \
ULONG ulFlags, \
LPMDB FAR * lppMDB) IPURE; \
MAPIMETHOD(OpenAddressBook) \
(THIS_ ULONG_PTR ulUIParam, \
LPCIID lpInterface, \
ULONG ulFlags, \
LPADRBOOK FAR * lppAdrBook) IPURE; \
MAPIMETHOD(OpenProfileSection) \
(THIS_ LPMAPIUID lpUID, \
LPCIID lpInterface, \
ULONG ulFlags, \
LPPROFSECT FAR * lppProfSect) IPURE; \
MAPIMETHOD(GetStatusTable) \
(THIS_ ULONG ulFlags, \
LPMAPITABLE FAR * lppTable) IPURE; \
MAPIMETHOD(OpenEntry) \
(THIS_ ULONG cbEntryID, \
LPENTRYID lpEntryID, \
LPCIID lpInterface, \
ULONG ulFlags, \
ULONG FAR * lpulObjType, \
LPUNKNOWN FAR * lppUnk) IPURE; \
MAPIMETHOD(CompareEntryIDs) \
(THIS_ ULONG cbEntryID1, \
LPENTRYID lpEntryID1, \
ULONG cbEntryID2, \
LPENTRYID lpEntryID2, \
ULONG ulFlags, \
ULONG FAR * lpulResult) IPURE; \
MAPIMETHOD(Advise) \
(THIS_ ULONG cbEntryID, \
LPENTRYID lpEntryID, \
ULONG ulEventMask, \
LPMAPIADVISESINK lpAdviseSink, \
ULONG FAR * lpulConnection) IPURE; \
MAPIMETHOD(Unadvise) \
(THIS_ ULONG ulConnection) IPURE; \
MAPIMETHOD(MessageOptions) \
(THIS_ ULONG_PTR ulUIParam, \
ULONG ulFlags, \
LPTSTR lpszAdrType, \
LPMESSAGE lpMessage) IPURE; \
MAPIMETHOD(QueryDefaultMessageOpt) \
(THIS_ LPTSTR lpszAdrType, \
ULONG ulFlags, \
ULONG FAR * lpcValues, \
LPSPropValue FAR * lppOptions) IPURE; \
MAPIMETHOD(EnumAdrTypes) \
(THIS_ ULONG ulFlags, \
ULONG FAR * lpcAdrTypes, \
LPTSTR FAR * FAR * lpppszAdrTypes) IPURE; \
MAPIMETHOD(QueryIdentity) \
(THIS_ ULONG FAR * lpcbEntryID, \
LPENTRYID FAR * lppEntryID) IPURE; \
MAPIMETHOD(Logoff) \
(THIS_ ULONG_PTR ulUIParam, \
ULONG ulFlags, \
ULONG ulReserved) IPURE; \
MAPIMETHOD(SetDefaultStore) \
(THIS_ ULONG ulFlags, \
ULONG cbEntryID, \
LPENTRYID lpEntryID) IPURE; \
MAPIMETHOD(AdminServices) \
(THIS_ ULONG ulFlags, \
LPSERVICEADMIN FAR * lppServiceAdmin) IPURE; \
MAPIMETHOD(ShowForm) \
(THIS_ ULONG_PTR ulUIParam, \
LPMDB lpMsgStore, \
LPMAPIFOLDER lpParentFolder, \
LPCIID lpInterface, \
ULONG ulMessageToken, \
LPMESSAGE lpMessageSent, \
ULONG ulFlags, \
ULONG ulMessageStatus, \
ULONG ulMessageFlags, \
ULONG ulAccess, \
LPSTR lpszMessageClass) IPURE; \
MAPIMETHOD(PrepareForm) \
(THIS_ LPCIID lpInterface, \
LPMESSAGE lpMessage, \
ULONG FAR * lpulMessageToken) IPURE; \
#undef INTERFACE
#define INTERFACE IMAPISession
DECLARE_MAPI_INTERFACE_(IMAPISession, IUnknown)
{
BEGIN_INTERFACE
MAPI_IUNKNOWN_METHODS(PURE)
MAPI_IMAPISESSION_METHODS(PURE)
};
/*DECLARE_MAPI_INTERFACE_PTR(IMAPISession, LPMAPISESSION);*/
/* IAddrBook Interface ----------------------------------------------------- */
/* CreateOneOff */
/****** MAPI_UNICODE ((ULONG) 0x80000000) */
/****** MAPI_SEND_NO_RICH_INFO ((ULONG) 0x00010000) */
/* RecipOptions */
/****** MAPI_UNICODE ((ULONG) 0x80000000) */
/* QueryDefaultRecipOpt */
/****** MAPI_UNICODE ((ULONG) 0x80000000) */
/* GetSearchPath */
/****** MAPI_UNICODE ((ULONG) 0x80000000) */
#define MAPI_IADDRBOOK_METHODS(IPURE) \
MAPIMETHOD(OpenEntry) \
(THIS_ ULONG cbEntryID, \
LPENTRYID lpEntryID, \
LPCIID lpInterface, \
ULONG ulFlags, \
ULONG FAR * lpulObjType, \
LPUNKNOWN FAR * lppUnk) IPURE; \
MAPIMETHOD(CompareEntryIDs) \
(THIS_ ULONG cbEntryID1, \
LPENTRYID lpEntryID1, \
ULONG cbEntryID2, \
LPENTRYID lpEntryID2, \
ULONG ulFlags, \
ULONG FAR * lpulResult) IPURE; \
MAPIMETHOD(Advise) \
(THIS_ ULONG cbEntryID, \
LPENTRYID lpEntryID, \
ULONG ulEventMask, \
LPMAPIADVISESINK lpAdviseSink, \
ULONG FAR * lpulConnection) IPURE; \
MAPIMETHOD(Unadvise) \
(THIS_ ULONG ulConnection) IPURE; \
MAPIMETHOD(CreateOneOff) \
(THIS_ LPTSTR lpszName, \
LPTSTR lpszAdrType, \
LPTSTR lpszAddress, \
ULONG ulFlags, \
ULONG FAR * lpcbEntryID, \
LPENTRYID FAR * lppEntryID) IPURE; \
MAPIMETHOD(NewEntry) \
(THIS_ ULONG_PTR ulUIParam, \
ULONG ulFlags, \
ULONG cbEIDContainer, \
LPENTRYID lpEIDContainer, \
ULONG cbEIDNewEntryTpl, \
LPENTRYID lpEIDNewEntryTpl, \
ULONG FAR * lpcbEIDNewEntry, \
LPENTRYID FAR * lppEIDNewEntry) IPURE; \
MAPIMETHOD(ResolveName) \
(THIS_ ULONG_PTR ulUIParam, \
ULONG ulFlags, \
LPTSTR lpszNewEntryTitle, \
LPADRLIST lpAdrList) IPURE; \
MAPIMETHOD(Address) \
(THIS_ ULONG_PTR FAR * lpulUIParam, \
LPADRPARM lpAdrParms, \
LPADRLIST FAR * lppAdrList) IPURE; \
MAPIMETHOD(Details) \
(THIS_ ULONG FAR * lpulUIParam, \
LPFNDISMISS lpfnDismiss, \
LPVOID lpvDismissContext, \
ULONG cbEntryID, \
LPENTRYID lpEntryID, \
LPFNBUTTON lpfButtonCallback, \
LPVOID lpvButtonContext, \
LPTSTR lpszButtonText, \
ULONG ulFlags) IPURE; \
MAPIMETHOD(RecipOptions) \
(THIS_ ULONG_PTR ulUIParam, \
ULONG ulFlags, \
LPADRENTRY lpRecip) IPURE; \
MAPIMETHOD(QueryDefaultRecipOpt) \
(THIS_ LPTSTR lpszAdrType, \
ULONG ulFlags, \
ULONG FAR * lpcValues, \
LPSPropValue FAR * lppOptions) IPURE; \
MAPIMETHOD(GetPAB) \
(THIS_ ULONG FAR * lpcbEntryID, \
LPENTRYID FAR * lppEntryID) IPURE; \
MAPIMETHOD(SetPAB) \
(THIS_ ULONG cbEntryID, \
LPENTRYID lpEntryID) IPURE; \
MAPIMETHOD(GetDefaultDir) \
(THIS_ ULONG FAR * lpcbEntryID, \
LPENTRYID FAR * lppEntryID) IPURE; \
MAPIMETHOD(SetDefaultDir) \
(THIS_ ULONG cbEntryID, \
LPENTRYID lpEntryID) IPURE; \
MAPIMETHOD(GetSearchPath) \
(THIS_ ULONG ulFlags, \
LPSRowSet FAR * lppSearchPath) IPURE; \
MAPIMETHOD(SetSearchPath) \
(THIS_ ULONG ulFlags, \
LPSRowSet lpSearchPath) IPURE; \
MAPIMETHOD(PrepareRecips) \
(THIS_ ULONG ulFlags, \
LPSPropTagArray lpPropTagArray, \
LPADRLIST lpRecipList) IPURE; \
#undef INTERFACE
#define INTERFACE IAddrBook
DECLARE_MAPI_INTERFACE_(IAddrBook, IMAPIProp)
{
BEGIN_INTERFACE
MAPI_IUNKNOWN_METHODS(PURE)
MAPI_IMAPIPROP_METHODS(PURE)
MAPI_IADDRBOOK_METHODS(PURE)
};
DECLARE_MAPI_INTERFACE_PTR(IAddrBook, LPADRBOOK);
/* IProfAdmin Interface ---------------------------------------------------- */
/* Flags for CreateProfile */
#define MAPI_DEFAULT_SERVICES 0x00000001
/* GetProfileTable */
/****** MAPI_UNICODE ((ULONG) 0x80000000) */
#define MAPI_IPROFADMIN_METHODS(IPURE) \
MAPIMETHOD(GetLastError) \
(THIS_ HRESULT hResult, \
ULONG ulFlags, \
LPMAPIERROR FAR * lppMAPIError) IPURE; \
MAPIMETHOD(GetProfileTable) \
(THIS_ ULONG ulFlags, \
LPMAPITABLE FAR * lppTable) IPURE; \
MAPIMETHOD(CreateProfile) \
(THIS_ LPTSTR lpszProfileName, \
LPTSTR lpszPassword, \
ULONG_PTR ulUIParam, \
ULONG ulFlags) IPURE; \
MAPIMETHOD(DeleteProfile) \
(THIS_ LPTSTR lpszProfileName, \
ULONG ulFlags) IPURE; \
MAPIMETHOD(ChangeProfilePassword) \
(THIS_ LPTSTR lpszProfileName, \
LPTSTR lpszOldPassword, \
LPTSTR lpszNewPassword, \
ULONG ulFlags) IPURE; \
MAPIMETHOD(CopyProfile) \
(THIS_ LPTSTR lpszOldProfileName, \
LPTSTR lpszOldPassword, \
LPTSTR lpszNewProfileName, \
ULONG_PTR ulUIParam, \
ULONG ulFlags) IPURE; \
MAPIMETHOD(RenameProfile) \
(THIS_ LPTSTR lpszOldProfileName, \
LPTSTR lpszOldPassword, \
LPTSTR lpszNewProfileName, \
ULONG_PTR ulUIParam, \
ULONG ulFlags) IPURE; \
MAPIMETHOD(SetDefaultProfile) \
(THIS_ LPTSTR lpszProfileName, \
ULONG ulFlags) IPURE; \
MAPIMETHOD(AdminServices) \
(THIS_ LPTSTR lpszProfileName, \
LPTSTR lpszPassword, \
ULONG_PTR ulUIParam, \
ULONG ulFlags, \
LPSERVICEADMIN FAR * lppServiceAdmin) IPURE; \
#undef INTERFACE
#define INTERFACE IProfAdmin
DECLARE_MAPI_INTERFACE_(IProfAdmin, IUnknown)
{
BEGIN_INTERFACE
MAPI_IUNKNOWN_METHODS(PURE)
MAPI_IPROFADMIN_METHODS(PURE)
};
/* IMsgServiceAdmin Interface ---------------------------------------------- */
/* Values for PR_RESOURCE_FLAGS in message service table */
#define SERVICE_DEFAULT_STORE 0x00000001
#define SERVICE_SINGLE_COPY 0x00000002
#define SERVICE_CREATE_WITH_STORE 0x00000004
#define SERVICE_PRIMARY_IDENTITY 0x00000008
#define SERVICE_NO_PRIMARY_IDENTITY 0x00000020
/* GetMsgServiceTable */
/****** MAPI_UNICODE ((ULONG) 0x80000000) */
/* GetProviderTable */
/****** MAPI_UNICODE ((ULONG) 0x80000000) */
#define MAPI_IMSGSERVICEADMIN_METHODS(IPURE) \
MAPIMETHOD(GetLastError) \
(THIS_ HRESULT hResult, \
ULONG ulFlags, \
LPMAPIERROR FAR * lppMAPIError) IPURE; \
MAPIMETHOD(GetMsgServiceTable) \
(THIS_ ULONG ulFlags, \
LPMAPITABLE FAR * lppTable) IPURE; \
MAPIMETHOD(CreateMsgService) \
(THIS_ LPTSTR lpszService, \
LPTSTR lpszDisplayName, \
ULONG_PTR ulUIParam, \
ULONG ulFlags) IPURE; \
MAPIMETHOD(DeleteMsgService) \
(THIS_ LPMAPIUID lpUID) IPURE; \
MAPIMETHOD(CopyMsgService) \
(THIS_ LPMAPIUID lpUID, \
LPTSTR lpszDisplayName, \
LPCIID lpInterfaceToCopy, \
LPCIID lpInterfaceDst, \
LPVOID lpObjectDst, \
ULONG_PTR ulUIParam, \
ULONG ulFlags) IPURE; \
MAPIMETHOD(RenameMsgService) \
(THIS_ LPMAPIUID lpUID, \
ULONG ulFlags, \
LPTSTR lpszDisplayName) IPURE; \
MAPIMETHOD(ConfigureMsgService) \
(THIS_ LPMAPIUID lpUID, \
ULONG_PTR ulUIParam, \
ULONG ulFlags, \
ULONG cValues, \
LPSPropValue lpProps) IPURE; \
MAPIMETHOD(OpenProfileSection) \
(THIS_ LPMAPIUID lpUID, \
LPCIID lpInterface, \
ULONG ulFlags, \
LPPROFSECT FAR * lppProfSect) IPURE; \
MAPIMETHOD(MsgServiceTransportOrder) \
(THIS_ ULONG cUID, \
LPMAPIUID lpUIDList, \
ULONG ulFlags) IPURE; \
MAPIMETHOD(AdminProviders) \
(THIS_ LPMAPIUID lpUID, \
ULONG ulFlags, \
LPPROVIDERADMIN FAR * lppProviderAdmin) IPURE; \
MAPIMETHOD(SetPrimaryIdentity) \
(THIS_ LPMAPIUID lpUID, \
ULONG ulFlags) IPURE; \
MAPIMETHOD(GetProviderTable) \
(THIS_ ULONG ulFlags, \
LPMAPITABLE FAR * lppTable) IPURE; \
#undef INTERFACE
#define INTERFACE IMsgServiceAdmin
DECLARE_MAPI_INTERFACE_(IMsgServiceAdmin, IUnknown)
{
BEGIN_INTERFACE
MAPI_IUNKNOWN_METHODS(PURE)
MAPI_IMSGSERVICEADMIN_METHODS(PURE)
};
#ifdef __cplusplus
} /* extern "C" */
#endif
#endif /* MAPIX_H */