|
|
#ifndef _WABAPI_H_
#define _WABAPI_H_
#ifdef __cplusplus
extern "C" {#endif
#ifdef WIN16
#ifdef GetLastError
#undef GetLastError
#endif // GetLastError
#endif // WIN16
typedef struct _WABACTIONITEM * LPWABACTIONITEM;
/* IWABObject Interface ---------------------------------------------------- */
#define CBIWABOBJECT sizeof(IWABOBJECT)
#define WAB_IWABOBJECT_METHODS(IPURE) \
MAPIMETHOD(GetLastError) \ (THIS_ HRESULT hResult, \ ULONG ulFlags, \ LPMAPIERROR FAR * lppMAPIError) IPURE; \ MAPIMETHOD(AllocateBuffer) \ (THIS_ ULONG cbSize, \ LPVOID FAR * lppBuffer) IPURE; \ MAPIMETHOD(AllocateMore) \ (THIS_ ULONG cbSize, \ LPVOID lpObject, \ LPVOID FAR * lppBuffer) IPURE; \ MAPIMETHOD(FreeBuffer) \ (THIS_ LPVOID lpBuffer) IPURE; \ MAPIMETHOD(Backup) \ (THIS_ LPSTR lpFileName) IPURE; \ MAPIMETHOD(Import) \ (THIS_ LPSTR lpImportParam) IPURE; \ MAPIMETHOD(Find) \ (THIS_ LPADRBOOK lpIAB, \ HWND hWnd) IPURE; \ MAPIMETHOD(VCardDisplay) \ (THIS_ LPADRBOOK lpIAB, \ HWND hWnd, \ LPSTR lpszFileName) IPURE; \ MAPIMETHOD(LDAPUrl) \ (THIS_ LPADRBOOK lpIAB, \ HWND hWnd, \ ULONG ulFlags, \ LPSTR lpszURL, \ LPMAILUSER *lppMailUser) IPURE; \ MAPIMETHOD(VCardCreate) \ (THIS_ LPADRBOOK lpIAB, \ ULONG ulFlags, \ LPSTR lpszVCard, \ LPMAILUSER lpMailUser) IPURE; \ MAPIMETHOD(VCardRetrieve) \ (THIS_ LPADRBOOK lpIAB, \ ULONG ulFlags, \ LPSTR lpszVCard, \ LPMAILUSER *lppMailUser) IPURE; \ MAPIMETHOD(GetMe) \ (THIS_ LPADRBOOK lpIAB, \ ULONG ulFlags, \ DWORD * lpdwAction, \ SBinary * lpsbEID, \ ULONG ulParam) IPURE; \ MAPIMETHOD(SetMe) \ (THIS_ LPADRBOOK lpIAB, \ ULONG ulFlags, \ SBinary sbEID, \ ULONG ulParam) IPURE; \
#undef INTERFACE
#define INTERFACE IWABObject
DECLARE_MAPI_INTERFACE_(IWABObject, IUnknown){ BEGIN_INTERFACE MAPI_IUNKNOWN_METHODS(PURE) WAB_IWABOBJECT_METHODS(PURE)};
DECLARE_MAPI_INTERFACE_PTR(IWABObject, LPWABOBJECT);
#undef INTERFACE
#define INTERFACE struct _IWABOBJECT
#undef METHOD_PREFIX
#define METHOD_PREFIX IWABOBJECT_
#undef LPVTBL_ELEM
#define LPVTBL_ELEM lpvtbl
#undef MAPIMETHOD_
#define MAPIMETHOD_(type, method) MAPIMETHOD_DECLARE(type, method, IWABOBJECT_)
MAPI_IUNKNOWN_METHODS(IMPL) WAB_IWABOBJECT_METHODS(IMPL)#undef MAPIMETHOD_
#define MAPIMETHOD_(type, method) MAPIMETHOD_TYPEDEF(type, method, IWABOBJECT_)
MAPI_IUNKNOWN_METHODS(IMPL) WAB_IWABOBJECT_METHODS(IMPL)#undef MAPIMETHOD_
#define MAPIMETHOD_(type, method) STDMETHOD_(type, method)
DECLARE_MAPI_INTERFACE(IWABOBJECT_){ BEGIN_INTERFACE MAPI_IUNKNOWN_METHODS(IMPL) WAB_IWABOBJECT_METHODS(IMPL)};
/*** WABObject_LDAPUrl flags ***/
// If this flag is specified and the LDAPUrl returns a single
// query result, instructs the WAB to return the result in the
// form of a MailUser object instead of displaying Details on it
// If there are multiple results to the query, fail ..
#define WABOBJECT_LDAPURL_RETURN_MAILUSER 0x00000001
// WAB 5.0x and higher:
// If your application supports Unicode and wants to pass ina Unicode
// URL to the WAB, you can cast the Unicode URL to an LPSTR and pass it
// to the LDAPUrl API, *also* setting ulFlags to MAPI_UNICODE to mark the URL
// as such. Casting is prefered to converting the string because
// (a) Converting the string may result in loss of data (b) since this is an
// already published interface we can't modify the interface.
// MAPI_UNICODE 0x80000000
/*** WABObject_GetMe returned parameter ***/// If the GetMe call results in the creation of a new 'Me' contact,
// the lpdwAction returned parameter will contain this value
// indicating to the caller that the object is freshly created and
// does not have any properties in it
#define WABOBJECT_ME_NEW 0x00000001
/*** WABObject_GetMe flags ***/// WABObject_GetMe will create a new ME object by default, if
// none already exists. To force the call to not-create an object, if
// one doesn't already exist, specify the WABOBJECT_ME_NOCREATE flag.
// If no me is found, the call fails with MAPI_E_NOT_FOUND.
// Other flag for WABObject_GetMe is AB_NO_DIALOG defined in wabdefs.h
#define WABOBJECT_ME_NOCREATE 0x00000002
/*** IWABObject_VCard Create/Retrieve ***/// Flags the WAB whether the lpszVCard parameter is a filename or if
// it is a NULL terminated string containing the compelte VCard contents
//
#define WAB_VCARD_FILE 0x00000000
#define WAB_VCARD_STREAM 0x00000001
#ifdef WIN16
BOOL WINAPI WABInitThread();#endif
//
// Input information to pass to WABOpen
//
typedef struct _tagWAB_PARAM{ ULONG cbSize; // sizeof(WAB_PARAM).
HWND hwnd; // hWnd of calling client Application. Can be NULL
LPSTR szFileName; // WAB File name to open. if NULL, opens default.
ULONG ulFlags; // See below
GUID guidPSExt; // A GUID that identifies the calling application's Property Sheet extensions
// The GUID can be used to determine whether the extension prop sheets are displayed or not.
} WAB_PARAM, * LPWAB_PARAM;
//flags for WAB_PARAM
#define WAB_USE_OE_SENDMAIL 0x00000001 // Tells WAB to use Outlook Express for e-mail before checking for a
// default Simple MAPI client. Default behaviour is to check for the
// Simple MAPI client first
#define WAB_ENABLE_PROFILES 0x00400000 // Invokes WAB in a Identity-aware session using Identity-Manager
// based profiles
//
// Root public entry points for WAB API
//
STDMETHODIMP WABOpen(LPADRBOOK FAR * lppAdrBook, LPWABOBJECT FAR * lppWABObject, LPWAB_PARAM lpWP, DWORD Reserved2);
typedef HRESULT (STDMETHODCALLTYPE WABOPEN)( LPADRBOOK FAR * lppAdrBook, LPWABOBJECT FAR * lppWABObject, LPWAB_PARAM lpWP, DWORD Reserved2);typedef WABOPEN FAR * LPWABOPEN;
STDMETHODIMP WABOpenEx(LPADRBOOK FAR * lppAdrBook, LPWABOBJECT FAR * lppWABObject, LPWAB_PARAM lpWP, DWORD Reserved, ALLOCATEBUFFER * fnAllocateBuffer, ALLOCATEMORE * fnAllocateMore, FREEBUFFER * fnFreeBuffer);
typedef HRESULT (STDMETHODCALLTYPE WABOPENEX)( LPADRBOOK FAR * lppAdrBook, LPWABOBJECT FAR * lppWABObject, LPWAB_PARAM lpWP, DWORD Reserved, ALLOCATEBUFFER * fnAllocateBuffer, ALLOCATEMORE * fnAllocateMore, FREEBUFFER * fnFreeBuffer);typedef WABOPENEX FAR * LPWABOPENEX;
/* --------------------- */typedef struct _WABIMPORTPARAM{ ULONG cbSize; // sizeof(WABIMPORTPARAM)
LPADRBOOK lpAdrBook;// ptr to the IAdrBook object (required)
HWND hWnd; // Parent HWND for any dialogs
ULONG ulFlags; // 0 or MAPI_DIALOG to show progress dialog and messages
LPSTR lpszFileName; // FileName to import or NULL .. if NULL will show FileOpen dialog
} WABIMPORTPARAM, FAR * LPWABIMPORTPARAM;
/* ---- WABEXTDISPLAY ----------------- *//* WABEXTDISPLAY Structure used in extending the WAB Details Property Dialogs
and for doing WAB Context Menu verb extensions. The structure is passed into the IWABExtInit::Initialize method of the implementor */
// Flags
#define WAB_DISPLAY_LDAPURL 0x00000001 // The object being displayed is an LDAP URL
// The URL can be found in the lpsz struct member
#define WAB_CONTEXT_ADRLIST 0x00000002 // THe lpv parameter contains a pointer to an
// AdrList structure corresponding to selected items
// on which to display a context menu
#define WAB_DISPLAY_ISNTDS 0x00000004 // Identifies that the entry being displayed originated
// on the NT Directory Service, for clients that use ADSI and
// retrieve additional information from the service.
// MAPI_UNICODE 0x80000000 // Indicates that the WED.lpsz string is actually a UNICODE
// string and should be cast to a (LPWSTR) before using it
// If this flag is not present then the WED.lpsz is a DBCS string
// and should be cast to an LPSTR before using.
// Struct
typedef struct _WABEXTDISPLAY{ ULONG cbSize; LPWABOBJECT lpWABObject; // pointer to IWABObject
LPADRBOOK lpAdrBook; // pointer to IAdrBook object
LPMAPIPROP lpPropObj; // Object being displayed
BOOL fReadOnly; // Indicates if this is a ReadOnly mode
BOOL fDataChanged; // Set by extension sheet to signal data change
ULONG ulFlags; // See above
LPVOID lpv; // Used for passing in specific data
LPTSTR lpsz; // Used for passing in specific data
} WABEXTDISPLAY, FAR * LPWABEXTDISPLAY;
/* --------------------- */
#define WAB_IWABEXTINIT_METHODS(IPURE) \
MAPIMETHOD(Initialize) \ (THIS_ LPWABEXTDISPLAY lpWABExtDisplay) IPURE; \
#undef INTERFACE
#define INTERFACE IWABExtInit
DECLARE_MAPI_INTERFACE_(IWABExtInit, IUnknown){ BEGIN_INTERFACE MAPI_IUNKNOWN_METHODS(PURE) WAB_IWABEXTINIT_METHODS(PURE)};
DECLARE_MAPI_INTERFACE_PTR(IWABExtInit, LPWABEXTINIT);
DEFINE_GUID(IID_IWABExtInit, 0xea22ebf0, 0x87a4, 0x11d1, 0x9a, 0xcf, 0x0, 0xa0, 0xc9, 0x1f, 0x9c, 0x8b);
/* --------------------- */
#ifndef WIN16
#define WAB_DLL_NAME TEXT("WAB32.DLL")
#else
#define WAB_DLL_NAME "WAB16.DLL"
#endif
#define WAB_DLL_PATH_KEY TEXT("Software\\Microsoft\\WAB\\DLLPath")
#ifdef __cplusplus
}#endif
#endif /* _WABAPI_H */
|
