Use FIXME's in stubs instead of TRACE's.
[wine] / include / ddeml.h
index d2d4d11..4987949 100644 (file)
  * DDEML library definitions
  *
  * Copyright 1997 Alexandre Julliard
+ * Copyright 1997 Len White
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+#ifndef __WINE_DDEML_H
+#define __WINE_DDEML_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif /* defined(__cplusplus) */
+
+/* Codepage Constants
  */
 
-#ifndef __WINE__DDEML_H
-#define __WINE__DDEML_H
+#define CP_WINANSI      1004
+#define CP_WINUNICODE   1200
+
+/* DDE synchronisation constants
+ */
+
+#define MSGF_DDEMGR 0x8001
+
+#define QID_SYNC       0xFFFFFFFF
+
+/*   Type variation for MS  deliberate departures from ANSI standards
+ */
+
+#define EXPENTRY CALLBACK
+
+#define SZDDESYS_TOPIC         TEXT("System")
+#define SZDDESYS_ITEM_TOPICS   TEXT("Topics")
+#define SZDDESYS_ITEM_SYSITEMS TEXT("SysItems")
+#define SZDDESYS_ITEM_RTNMSG   TEXT("ReturnMessage")
+#define SZDDESYS_ITEM_STATUS   TEXT("Status")
+#define SZDDESYS_ITEM_FORMATS  TEXT("Formats")
+#define SZDDESYS_ITEM_HELP     TEXT("Help")
+#define SZDDE_ITEM_ITEMLIST    TEXT("TopicItemList")
+
+/***************************************************
+
+      FLAGS Section - copied from Microsoft SDK as must be standard, probably Copyright Microsoft Corporation
+
+***************************************************/
+
+#define     XST_NULL              0
+#define     XST_INCOMPLETE        1
+#define     XST_CONNECTED         2
+#define     XST_INIT1             3
+#define     XST_INIT2             4
+#define     XST_REQSENT           5
+#define     XST_DATARCVD          6
+#define     XST_POKESENT          7
+#define     XST_POKEACKRCVD       8
+#define     XST_EXECSENT          9
+#define     XST_EXECACKRCVD      10
+#define     XST_ADVSENT          11
+#define     XST_UNADVSENT        12
+#define     XST_ADVACKRCVD       13
+#define     XST_UNADVACKRCVD     14
+#define     XST_ADVDATASENT      15
+#define     XST_ADVDATAACKRCVD   16
+
+#define     ST_CONNECTED            0x0001
+#define     ST_ADVISE               0x0002
+#define     ST_ISLOCAL              0x0004
+#define     ST_BLOCKED              0x0008
+#define     ST_CLIENT               0x0010
+#define     ST_TERMINATED           0x0020
+#define     ST_INLIST               0x0040
+#define     ST_BLOCKNEXT            0x0080
+#define     ST_ISSELF               0x0100
+
+/*
+ * DdeEnableCallback function codes
+ */
+
+#define     EC_ENABLEALL                 0
+#define     EC_ENABLEONE                 ST_BLOCKNEXT
+#define     EC_DISABLE                   ST_BLOCKED
+#define     EC_QUERYWAITING              2
+
+/*
+ * Callback filter flags for use with standard apps.
+ */
+
+#define     CBF_FAIL_SELFCONNECTIONS     0x00001000
+#define     CBF_FAIL_CONNECTIONS         0x00002000
+#define     CBF_FAIL_ADVISES             0x00004000
+#define     CBF_FAIL_EXECUTES            0x00008000
+#define     CBF_FAIL_POKES               0x00010000
+#define     CBF_FAIL_REQUESTS            0x00020000
+#define     CBF_FAIL_ALLSVRXACTIONS      0x0003f000
+
+#define     CBF_SKIP_CONNECT_CONFIRMS    0x00040000
+#define     CBF_SKIP_REGISTRATIONS       0x00080000
+#define     CBF_SKIP_UNREGISTRATIONS     0x00100000
+#define     CBF_SKIP_DISCONNECTS         0x00200000
+#define     CBF_SKIP_ALLNOTIFICATIONS    0x003c0000
+
+#define     CBR_BLOCK                    ((HDDEDATA)~0UL)
+
+/*
+ * Application command flags
+ */
+#define     APPCMD_CLIENTONLY            0x00000010L
+#define     APPCMD_FILTERINITS           0x00000020L
+#define     APPCMD_MASK                  0x00000FF0L
+
+/*
+ * Application classification flags
+ */
+
+#define     APPCLASS_STANDARD            0x00000000L
+#define     APPCLASS_MONITOR             0x00000001L
+#define     APPCLASS_MASK                0x0000000FL
+
+/*
+ * Callback filter flags for use with MONITOR apps - 0 implies no monitor
+ * callbacks.
+ */
+#define     MF_HSZ_INFO                  0x01000000
+#define     MF_SENDMSGS                  0x02000000
+#define     MF_POSTMSGS                  0x04000000
+#define     MF_CALLBACKS                 0x08000000
+#define     MF_ERRORS                    0x10000000
+#define     MF_LINKS                     0x20000000
+#define     MF_CONV                      0x40000000
+
+#define     MF_MASK                      0xFF000000
+
+/*
+ *     DdeNameService service name flags
+ */
+
+#define     DNS_REGISTER                0x0001
+#define     DNS_UNREGISTER              0x0002
+#define     DNS_FILTERON                0x0004
+#define     DNS_FILTEROFF               0x0008
+
+
+/****************************************************
+
+      End of Flags section
+
+****************************************************/
 
-#include "wintypes.h"
+/****************************************************
 
-typedef DWORD HCONVLIST;
-typedef DWORD HCONV;
-typedef DWORD HSZ;
-typedef DWORD HDDEDATA;
+       Message Types Section
 
-typedef HDDEDATA (CALLBACK *PFNCALLBACK16)(UINT16,UINT16,HCONV,HSZ,HSZ,
-                                           HDDEDATA,DWORD,DWORD);
-typedef HDDEDATA (CALLBACK *PFNCALLBACK32)(UINT32,UINT32,HCONV,HSZ,HSZ,
-                                           HDDEDATA,DWORD,DWORD);
-DECL_WINELIB_TYPE(PFNCALLBACK);
+****************************************************/
 
-typedef struct
+#define XTYPF_NOBLOCK          0x0002          /* CBR_NOBLOCK will not work */
+#define XTYPF_NODATA           0x0004          /* DDE_FDEFERUPD  */
+#define XTYPF_ACKREQ           0x0008          /* DDE_FACKREQ */
+
+#define XCLASS_MASK            0xFC00
+#define XCLASS_BOOL            0x1000
+#define XCLASS_DATA            0x2000
+#define XCLASS_FLAGS           0x4000
+#define        XCLASS_NOTIFICATION     0x8000
+
+#define XTYP_ERROR             (0x0000 | XCLASS_NOTIFICATION | XTYPF_NOBLOCK)
+#define XTYP_ADVDATA           (0x0010 | XCLASS_FLAGS)
+#define XTYP_ADVREQ            (0x0020 | XCLASS_DATA | XTYPF_NOBLOCK)
+#define XTYP_ADVSTART          (0x0030 | XCLASS_BOOL)
+#define XTYP_ADVSTOP           (0x0040 | XCLASS_NOTIFICATION)
+#define XTYP_EXECUTE           (0x0050 | XCLASS_FLAGS)
+#define XTYP_CONNECT           (0x0060 | XCLASS_BOOL | XTYPF_NOBLOCK)
+#define XTYP_CONNECT_CONFIRM   (0x0070 | XCLASS_NOTIFICATION | XTYPF_NOBLOCK)
+#define XTYP_XACT_COMPLETE     (0x0080 | XCLASS_NOTIFICATION )
+#define XTYP_POKE              (0x0090 | XCLASS_FLAGS)
+#define XTYP_REGISTER          (0x00A0 | XCLASS_NOTIFICATION | XTYPF_NOBLOCK )
+#define XTYP_REQUEST           (0x00B0 | XCLASS_DATA )
+#define XTYP_DISCONNECT                (0x00C0 | XCLASS_NOTIFICATION | XTYPF_NOBLOCK )
+#define XTYP_UNREGISTER                (0x00D0 | XCLASS_NOTIFICATION | XTYPF_NOBLOCK )
+#define XTYP_WILDCONNECT       (0x00E0 | XCLASS_DATA | XTYPF_NOBLOCK)
+
+#define XTYP_MASK              0x00F0
+#define XTYP_SHIFT             4
+
+#define TIMEOUT_ASYNC           0xFFFFFFFF
+
+#define CADV_LATEACK           0xFFFF
+
+/**************************************************
+
+       End of Message Types Section
+
+****************************************************/
+
+/*****************************************************
+
+       DDE Codes for wStatus field
+
+*****************************************************/
+
+#define DDE_FACK               0x8000
+#define DDE_FBUSY              0x4000
+#define DDE_FDEFERUPD          0x4000
+#define DDE_FACKREQ            0x8000
+#define DDE_FRELEASE           0x2000
+#define DDE_FREQUESTED         0x1000
+#define DDE_FAPPSTATUS         0x00FF
+#define DDE_FNOTPROCESSED      0x0000
+
+#define DDE_FACKRESERVED        (~(DDE_FACK | DDE_FBUSY | DDE_FAPPSTATUS))
+#define DDE_FADVRESERVED        (~(DDE_FACKREQ | DDE_FDEFERUPD))
+#define DDE_FDATRESERVED        (~(DDE_FACKREQ | DDE_FRELEASE | DDE_FREQUESTED))
+#define DDE_FPOKRESERVED        (~(DDE_FRELEASE))
+
+/*****************************************************
+
+       End of wStatus codes
+
+*****************************************************/
+
+/****************************************************
+
+      Return Codes section again copied from SDK as must be same
+
+*****************************************************/
+
+#define     DMLERR_NO_ERROR                    0       /* must be 0 */
+
+#define     DMLERR_FIRST                       0x4000
+
+#define     DMLERR_ADVACKTIMEOUT               0x4000
+#define     DMLERR_BUSY                        0x4001
+#define     DMLERR_DATAACKTIMEOUT              0x4002
+#define     DMLERR_DLL_NOT_INITIALIZED         0x4003
+#define     DMLERR_DLL_USAGE                   0x4004
+#define     DMLERR_EXECACKTIMEOUT              0x4005
+#define     DMLERR_INVALIDPARAMETER            0x4006
+#define     DMLERR_LOW_MEMORY                  0x4007
+#define     DMLERR_MEMORY_ERROR                0x4008
+#define     DMLERR_NOTPROCESSED                0x4009
+#define     DMLERR_NO_CONV_ESTABLISHED         0x400a
+#define     DMLERR_POKEACKTIMEOUT              0x400b
+#define     DMLERR_POSTMSG_FAILED              0x400c
+#define     DMLERR_REENTRANCY                  0x400d
+#define     DMLERR_SERVER_DIED                 0x400e
+#define     DMLERR_SYS_ERROR                   0x400f
+#define     DMLERR_UNADVACKTIMEOUT             0x4010
+#define     DMLERR_UNFOUND_QUEUE_ID            0x4011
+
+#define     DMLERR_LAST                        0x4011
+
+#define     HDATA_APPOWNED                    0x0001
+
+/*****************************************************
+
+      End of Return Codes and Microsoft section
+
+******************************************************/
+
+
+
+DECLARE_HANDLE(HCONVLIST);
+DECLARE_HANDLE(HCONV);
+DECLARE_HANDLE(HSZ);
+DECLARE_HANDLE(HDDEDATA);
+
+
+
+/*******************************************************
+
+       API Entry Points
+
+*******************************************************/
+
+typedef HDDEDATA (CALLBACK *PFNCALLBACK)(UINT, UINT, HCONV, HSZ, HSZ,
+                                        HDDEDATA, ULONG_PTR, ULONG_PTR);
+
+/***************************************************
+
+       Externally visible data structures
+
+***************************************************/
+
+typedef struct tagHSZPAIR
 {
-    UINT16  cb;
-    UINT16  wFlags;
-    UINT16  wCountryID;
-    INT16   iCodePage;
-    DWORD   dwLangID;
-    DWORD   dwSecurity;
-} CONVCONTEXT16, *LPCONVCONTEXT16;
+    HSZ hszSvc;
+    HSZ hszTopic;
+} HSZPAIR, *PHSZPAIR;
 
-typedef struct
+typedef struct tagCONVCONTEXT
 {
-    UINT32  cb;
-    UINT32  wFlags;
-    UINT32  wCountryID;
-    INT32   iCodePage;
+    UINT  cb;
+    UINT  wFlags;
+    UINT  wCountryID;
+    INT   iCodePage;
     DWORD   dwLangID;
     DWORD   dwSecurity;
-} CONVCONTEXT32, *LPCONVCONTEXT32;
+} CONVCONTEXT, *PCONVCONTEXT;
+
+typedef struct tagCONVINFO
+{
+    DWORD              cb;
+    DWORD              hUser;
+    HCONV              hConvPartner;
+    HSZ                        hszSvcPartner;
+    HSZ                        hszServiceReq;
+    HSZ                        hszTopic;
+    HSZ                        hszItem;
+    UINT               wFmt;
+    UINT               wType;
+    UINT               wStatus;
+    UINT               wConvst;
+    UINT               wLastError;
+    HCONVLIST          hConvList;
+    CONVCONTEXT                ConvCtxt;
+    HWND               hwnd;
+    HWND               hwndPartner;
+} CONVINFO, *PCONVINFO;
+
+/*            Interface Definitions            */
 
-DECL_WINELIB_TYPE(CONVCONTEXT);
-DECL_WINELIB_TYPE(LPCONVCONTEXT);
 
-UINT16    WINAPI DdeInitialize16(LPDWORD,PFNCALLBACK16,DWORD,DWORD);
-UINT32    WINAPI DdeInitialize32A(LPDWORD,PFNCALLBACK32,DWORD,DWORD);
-UINT32    WINAPI DdeInitialize32W(LPDWORD,PFNCALLBACK32,DWORD,DWORD);
+UINT    WINAPI DdeInitializeA(LPDWORD,PFNCALLBACK,DWORD,DWORD);
+UINT    WINAPI DdeInitializeW(LPDWORD,PFNCALLBACK,DWORD,DWORD);
 #define   DdeInitialize WINELIB_NAME_AW(DdeInitialize)
-BOOL16    WINAPI DdeUninitialize16(DWORD);
-BOOL32    WINAPI DdeUninitialize32(DWORD);
-#define   DdeUninitialize WINELIB_NAME(DdeUninitialize)
-HCONV     WINAPI DdeConnect16(DWORD,HSZ,HSZ,LPCONVCONTEXT16);
-HCONV     WINAPI DdeConnect32(DWORD,HSZ,HSZ,LPCONVCONTEXT32);
-#define   DdeConnect WINELIB_NAME(DdeConnect)
-BOOL16    WINAPI DdeDisconnect16(HCONV);
-BOOL32    WINAPI DdeDisconnect32(HCONV);
-#define   DdeDisconnect WINELIB_NAME(DdeDisconnect)
+BOOL    WINAPI DdeUninitialize(DWORD);
+HCONVLIST WINAPI DdeConnectList(DWORD,HSZ,HSZ,HCONVLIST,PCONVCONTEXT);
+HCONV     WINAPI DdeQueryNextServer(HCONVLIST, HCONV);
+DWORD     WINAPI DdeQueryStringA(DWORD, HSZ, LPSTR, DWORD, INT);
+DWORD     WINAPI DdeQueryStringW(DWORD, HSZ, LPWSTR, DWORD, INT);
+#define   DdeQueryString WINELIB_NAME_AW(DdeQueryString)
+BOOL      WINAPI DdeDisconnectList(HCONVLIST);
+HCONV     WINAPI DdeConnect(DWORD,HSZ,HSZ,PCONVCONTEXT);
+BOOL      WINAPI DdeDisconnect(HCONV);
+HDDEDATA  WINAPI DdeCreateDataHandle(DWORD,LPBYTE,DWORD,DWORD,HSZ,UINT,UINT);
 HCONV     WINAPI DdeReconnect(HCONV);
-HSZ       WINAPI DdeCreateStringHandle16(DWORD,LPCSTR,INT16);
-HSZ       WINAPI DdeCreateStringHandle32A(DWORD,LPCSTR,INT32);
-HSZ       WINAPI DdeCreateStringHandle32W(DWORD,LPCWSTR,INT32);
+HSZ       WINAPI DdeCreateStringHandleA(DWORD,LPCSTR,INT);
+HSZ       WINAPI DdeCreateStringHandleW(DWORD,LPCWSTR,INT);
 #define   DdeCreateStringHandle WINELIB_NAME_AW(DdeCreateStringHandle)
-BOOL16    WINAPI DdeFreeStringHandle16(DWORD,HSZ);
-BOOL32    WINAPI DdeFreeStringHandle32(DWORD,HSZ);
-#define   DdeFreeStringHandle WINELIB_NAME(DdeFreeStringHandle)
-BOOL16    WINAPI DdeFreeDataHandle16(HDDEDATA);
-BOOL32    WINAPI DdeFreeDataHandle32(HDDEDATA);
-#define   DdeFreeDataHandle WINELIB_NAME(DdeFreeDataHandle)
-BOOL16    WINAPI DdeKeepStringHandle16(DWORD,HSZ);
-BOOL32    WINAPI DdeKeepStringHandle32(DWORD,HSZ);
-#define   DdeKeepStringHandle WINELIB_NAME(DdeKeepStringHandle)
-HDDEDATA  WINAPI DdeClientTransaction16(LPVOID,DWORD,HCONV,HSZ,UINT16,
-                                        UINT16,DWORD,LPDWORD);
-HDDEDATA  WINAPI DdeClientTransaction32(LPBYTE,DWORD,HCONV,HSZ,UINT32,
-                                        UINT32,DWORD,LPDWORD);
-#define   DdeClientTransaction WINELIB_NAME(DdeClientTransaction)
-HDDEDATA  WINAPI DdeNameService16(DWORD,HSZ,HSZ,UINT16);
-HDDEDATA  WINAPI DdeNameService32(DWORD,HSZ,HSZ,UINT32);
-#define   DdeNameService WINELIB_NAME(DdeNameService)
-UINT16    WINAPI DdeGetLastError16(DWORD);
-UINT32    WINAPI DdeGetLastError32(DWORD);
-#define   DdeGetLastError WINELIB_NAME(DdeGetLastError)
-
-#endif  /* __WINE__DDEML_H */
+BOOL      WINAPI DdeFreeStringHandle(DWORD,HSZ);
+BOOL      WINAPI DdeFreeDataHandle(HDDEDATA);
+BOOL      WINAPI DdeKeepStringHandle(DWORD,HSZ);
+HDDEDATA  WINAPI DdeClientTransaction(LPBYTE,DWORD,HCONV,HSZ,UINT,UINT,DWORD,LPDWORD);
+BOOL     WINAPI DdeAbandonTransaction(DWORD idInst, HCONV hConv, DWORD idTransaction);
+BOOL      WINAPI DdeImpersonateClient(HCONV);
+BOOL      WINAPI DdePostAdvise(DWORD,HSZ,HSZ);
+HDDEDATA  WINAPI DdeAddData(HDDEDATA,LPBYTE,DWORD,DWORD);
+DWORD     WINAPI DdeGetData(HDDEDATA,LPBYTE,DWORD,DWORD);
+LPBYTE    WINAPI DdeAccessData(HDDEDATA,LPDWORD);
+BOOL      WINAPI DdeUnaccessData(HDDEDATA);
+BOOL      WINAPI DdeEnableCallback(DWORD,HCONV,UINT);
+INT       WINAPI DdeCmpStringHandles(HSZ,HSZ);
+BOOL      WINAPI DdeSetUserHandle(HCONV,DWORD,DWORD);
+
+HDDEDATA  WINAPI DdeNameService(DWORD,HSZ,HSZ,UINT);
+UINT      WINAPI DdeGetLastError(DWORD);
+UINT      WINAPI DdeQueryConvInfo(HCONV,DWORD,PCONVINFO);
+
+#ifdef __cplusplus
+} /* extern "C" */
+#endif /* defined(__cplusplus) */
+
+#endif  /* __WINE_DDEML_H */