#ifndef _WABAPI_H_ #pragma option push -b -a8 -pc -A- /*P_O_Push*/ #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 #pragma option pop /*P_O_Pop*/ #endif /* _WABAPI_H */