|
|
;begin_both/*++ BUILD Version: 0001 // Increment this if a change has global effects --*/;end_both
;begin_internal/****************************** Module Header ******************************\* Module Name: ddemlp.h** Copyright (c) Microsoft Corporation. All rights reserved.** This header file contains stuff used by all parts of USER DDEML code.** History:* 10-28-91 Sanfords Created* 4-21-92 Sanfords Merged into ddeml.w\***************************************************************************/#ifndef _INC_DDEMLPH#define _INC_DDEMLPH;end_internal/*****************************************************************************\* ** ddeml.h - DDEML API header file ** ** Version 3.10 ** ** Copyright (c) Microsoft Corporation. All rights reserved. ** *\*****************************************************************************/#ifndef _INC_DDEMLH#define _INC_DDEMLH
#ifdef __cplusplus ;bothextern "C" { ;both#endif /* __cplusplus */ ;both ;both/******** public types ********/
DECLARE_HANDLE(HCONVLIST);DECLARE_HANDLE(HCONV);DECLARE_HANDLE(HSZ);DECLARE_HANDLE(HDDEDATA);#define EXPENTRY CALLBACK
/* the following structure is for use with XTYP_WILDCONNECT processing. */
typedef struct tagHSZPAIR { HSZ hszSvc; HSZ hszTopic;} HSZPAIR;typedef HSZPAIR FAR *PHSZPAIR;
/* The following structure is used by DdeConnect() and DdeConnectList() and by XTYP_CONNECT and XTYP_WILDCONNECT callbacks. */
typedef struct tagCONVCONTEXT { UINT cb; /* set to sizeof(CONVCONTEXT) */ UINT wFlags; /* none currently defined. */ UINT wCountryID; /* country code for topic/item strings used. */ int iCodePage; /* codepage used for topic/item strings. */ DWORD dwLangID; /* language ID for topic/item strings. */ DWORD dwSecurity; /* Private security code. */ SECURITY_QUALITY_OF_SERVICE qos; /* client side's quality of service */} CONVCONTEXT;typedef CONVCONTEXT FAR *PCONVCONTEXT;
/* The following structure is used by DdeQueryConvInfo(): */
typedef struct tagCONVINFO { DWORD cb; /* sizeof(CONVINFO) */ DWORD_PTR hUser; /* user specified field */ HCONV hConvPartner; /* hConv on other end or 0 if non-ddemgr partner */ HSZ hszSvcPartner; /* app name of partner if obtainable */ HSZ hszServiceReq; /* AppName requested for connection */ HSZ hszTopic; /* Topic name for conversation */ HSZ hszItem; /* transaction item name or NULL if quiescent */ UINT wFmt; /* transaction format or NULL if quiescent */ UINT wType; /* XTYP_ for current transaction */ UINT wStatus; /* ST_ constant for current conversation */ UINT wConvst; /* XST_ constant for current transaction */ UINT wLastError; /* last transaction error. */ HCONVLIST hConvList; /* parent hConvList if this conversation is in a list */ CONVCONTEXT ConvCtxt; /* conversation context */ HWND hwnd; /* window handle for this conversation */ HWND hwndPartner; /* partner window handle for this conversation */} CONVINFO;typedef CONVINFO FAR *PCONVINFO;
/***** conversation states (usState) *****/
#define XST_NULL 0 /* quiescent states */#define XST_INCOMPLETE 1#define XST_CONNECTED 2#define XST_INIT1 3 /* mid-initiation states */#define XST_INIT2 4#define XST_REQSENT 5 /* active conversation states */#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
/* used in LOWORD(dwData1) of XTYP_ADVREQ callbacks... */#define CADV_LATEACK 0xFFFF
/***** conversation status bits (fsStatus) *****/
#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#define ST_TERMINATE_RECEIVED 0x0200 ;internal#define ST_FREE_CONV_RES_NOW 0x0800 // See FreeConversationResources() ;internal#define ST_INTRA_PROCESS 0x8000 ;internal#define ST_UNICODE_EXECUTE 0x4000 ;internal#define ST_BLOCKALLNEXT 0x2000 ;internal#define ST_PROCESSING 0x1000 // See CheckForQueuedMessages() ;internal
/* DDE constants 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))
/***** message filter hook types *****/
#define MSGF_DDEMGR 0x8001
/***** codepage constants ****/
#define CP_WINANSI 1004 /* default codepage for windows & old DDE convs. */#define CP_WINUNICODE 1200#ifdef UNICODE#define CP_WINNEUTRAL CP_WINUNICODE#else // !UNICODE#define CP_WINNEUTRAL CP_WINANSI#endif // !UNICODE
/***** transaction types *****/
#define XTYPF_NOBLOCK 0x0002 /* CBR_BLOCK 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 /* shift to turn XTYP_ into an index */
/***** Timeout constants *****/
#define TIMEOUT_ASYNC 0xFFFFFFFF
/***** Transaction ID constants *****/
#define QID_SYNC 0xFFFFFFFF
/****** public strings used in DDE ******/
#ifdef UNICODE#define SZDDESYS_TOPIC L"System"#define SZDDESYS_ITEM_TOPICS L"Topics"#define SZDDESYS_ITEM_SYSITEMS L"SysItems"#define SZDDESYS_ITEM_RTNMSG L"ReturnMessage"#define SZDDESYS_ITEM_STATUS L"Status"#define SZDDESYS_ITEM_FORMATS L"Formats"#define SZDDESYS_ITEM_HELP L"Help"#define SZDDE_ITEM_ITEMLIST L"TopicItemList"#else#define SZDDESYS_TOPIC "System"#define SZDDESYS_ITEM_TOPICS "Topics"#define SZDDESYS_ITEM_SYSITEMS "SysItems"#define SZDDESYS_ITEM_RTNMSG "ReturnMessage"#define SZDDESYS_ITEM_STATUS "Status"#define SZDDESYS_ITEM_FORMATS "Formats"#define SZDDESYS_ITEM_HELP "Help"#define SZDDE_ITEM_ITEMLIST "TopicItemList"#endif
/****** API entry points ******/
typedef HDDEDATA CALLBACK FNCALLBACK(UINT wType, UINT wFmt, HCONV hConv, HSZ hsz1, HSZ hsz2, HDDEDATA hData, ULONG_PTR dwData1, ULONG_PTR dwData2);typedef HDDEDATA (CALLBACK *PFNCALLBACK)(UINT wType, UINT wFmt, HCONV hConv, HSZ hsz1, HSZ hsz2, HDDEDATA hData, ULONG_PTR dwData1, ULONG_PTR dwData2);
#define CBR_BLOCK ((HDDEDATA)-1)
/* DLL registration functions */
UINT WINAPI DdeInitialize%( IN OUT LPDWORD pidInst, IN PFNCALLBACK pfnCallback, IN DWORD afCmd, IN DWORD ulRes);
/* * 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 CBF_MASK 0x003ff000L ;internal#define CBF_MONMASK 0x0027f000L ;internal
/* * Application command flags */#define APPCMD_CLIENTONLY 0x00000010L#define APPCMD_FILTERINITS 0x00000020L#define APPCMD_UNINIT_ASAP 0x00000800L ;internal#define APPCMD_MASK 0x00000FF0L
/* * Application classification flags */#define APPCLASS_STANDARD 0x00000000L#define APPCLASS_MASK 0x0000000FL#define APPCLASS_UNICODE 0x00000001L ;internal
BOOL WINAPI DdeUninitialize( IN DWORD idInst);
/* * conversation enumeration functions */
HCONVLIST WINAPI DdeConnectList( IN DWORD idInst, IN HSZ hszService, IN HSZ hszTopic, IN HCONVLIST hConvList, IN PCONVCONTEXT pCC);HCONV WINAPI DdeQueryNextServer( IN HCONVLIST hConvList, IN HCONV hConvPrev);BOOL WINAPI DdeDisconnectList( IN HCONVLIST hConvList);
/* * conversation control functions */
HCONV WINAPI DdeConnect( IN DWORD idInst, IN HSZ hszService, IN HSZ hszTopic, IN PCONVCONTEXT pCC);BOOL WINAPI DdeDisconnect( IN OUT HCONV hConv);HCONV WINAPI DdeReconnect( IN HCONV hConv);UINT WINAPI DdeQueryConvInfo( IN HCONV hConv, IN DWORD idTransaction, IN OUT PCONVINFO pConvInfo);BOOL WINAPI DdeSetUserHandle( IN HCONV hConv, IN DWORD id, IN DWORD_PTR hUser);BOOL WINAPI DdeAbandonTransaction( IN DWORD idInst, IN HCONV hConv, IN DWORD idTransaction);
/* * app server interface functions */
BOOL WINAPI DdePostAdvise( IN DWORD idInst, IN HSZ hszTopic, IN HSZ hszItem);BOOL WINAPI DdeEnableCallback( IN DWORD idInst, IN HCONV hConv, IN UINT wCmd);BOOL WINAPI DdeImpersonateClient( IN HCONV hConv);BOOL WINAPI DdeGetQualityOfService(HWND hwndClient, HWND hwndServer, ;internal PSECURITY_QUALITY_OF_SERVICE pqos); ;internal
#define EC_ENABLEALL 0#define EC_ENABLEONE ST_BLOCKNEXT#define EC_DISABLE ST_BLOCKED#define EC_QUERYWAITING 2#define EC_ENABLEONEOFALL 0x2000 ;internal#define EC_CHECKQUEUEONCE 0x1000 ;internal#define EC_CHECKQUEUE 0x0800 ;internal
HDDEDATA WINAPI DdeNameService( IN DWORD idInst, IN HSZ hsz1, IN HSZ hsz2, IN UINT afCmd);
#define DNS_REGISTER 0x0001#define DNS_UNREGISTER 0x0002#define DNS_FILTERON 0x0004#define DNS_FILTEROFF 0x0008#define UM_REGISTER (WM_USER + 200) ;internal#define UM_UNREGISTER (WM_USER + 201) ;internal
/* * app client interface functions */
HDDEDATA WINAPI DdeClientTransaction( IN LPBYTE pData, IN DWORD cbData, IN HCONV hConv, IN HSZ hszItem, IN UINT wFmt, IN UINT wType, IN DWORD dwTimeout, OUT LPDWORD pdwResult);
/* *data transfer functions */
HDDEDATA WINAPI DdeCreateDataHandle( IN DWORD idInst, IN LPBYTE pSrc, IN DWORD cb, IN DWORD cbOff, IN HSZ hszItem, IN UINT wFmt, IN UINT afCmd);HDDEDATA WINAPI DdeAddData( IN HDDEDATA hData, IN LPBYTE pSrc, IN DWORD cb, IN DWORD cbOff);DWORD WINAPI DdeGetData( IN HDDEDATA hData, OUT LPBYTE pDst, IN DWORD cbMax, IN DWORD cbOff);LPBYTE WINAPI DdeAccessData( IN HDDEDATA hData, OUT LPDWORD pcbDataSize);BOOL WINAPI DdeUnaccessData( IN HDDEDATA hData);BOOL WINAPI DdeFreeDataHandle( IN OUT HDDEDATA hData);
#define HDATA_APPOWNED 0x0001
;begin_internal#define HDATA_READONLY 0x8000#define HDATA_NOAPPFREE 0x4000#define HDATA_EXECUTE 0x0100#define HDATA_INITIALIZED 0x0200;end_internal
UINT WINAPI DdeGetLastError( IN DWORD idInst);
#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
HSZ WINAPI DdeCreateStringHandle%( IN DWORD idInst, IN LPCTSTR% psz, IN int iCodePage);DWORD WINAPI DdeQueryString%( IN DWORD idInst, IN HSZ hsz, IN OUT LPTSTR% psz, IN DWORD cchMax, IN int iCodePage);BOOL WINAPI DdeFreeStringHandle( IN DWORD idInst, IN OUT HSZ hsz);BOOL WINAPI DdeKeepStringHandle( IN DWORD idInst, IN OUT HSZ hsz);int WINAPI DdeCmpStringHandles( IN HSZ hsz1, IN HSZ hsz2);
#ifndef NODDEMLSPY/* * DDEML public debugging header file info */
typedef struct tagDDEML_MSG_HOOK_DATA { // new for NT UINT_PTR uiLo; // unpacked lo and hi parts of lParam UINT_PTR uiHi; DWORD cbData; // amount of data in message, if any. May be > than 32 bytes. DWORD Data[8]; // data peeking by DDESPY is limited to 32 bytes.} DDEML_MSG_HOOK_DATA, *PDDEML_MSG_HOOK_DATA;
typedef struct tagMONMSGSTRUCT { UINT cb; HWND hwndTo; DWORD dwTime; HANDLE hTask; UINT wMsg; WPARAM wParam; LPARAM lParam; DDEML_MSG_HOOK_DATA dmhd; // new for NT} MONMSGSTRUCT, *PMONMSGSTRUCT;
typedef struct tagMONCBSTRUCT { UINT cb; DWORD dwTime; HANDLE hTask; DWORD dwRet; UINT wType; UINT wFmt; HCONV hConv; HSZ hsz1; HSZ hsz2; HDDEDATA hData; ULONG_PTR dwData1; ULONG_PTR dwData2; CONVCONTEXT cc; // new for NT for XTYP_CONNECT callbacks DWORD cbData; // new for NT for data peeking DWORD Data[8]; // new for NT for data peeking} MONCBSTRUCT, *PMONCBSTRUCT;
typedef struct tagMONHSZSTRUCT% { UINT cb; BOOL fsAction; /* MH_ value */ DWORD dwTime; HSZ hsz; HANDLE hTask; TCHAR% str[1];} MONHSZSTRUCT%, *PMONHSZSTRUCT%;
#define MH_CREATE 1#define MH_KEEP 2#define MH_DELETE 3#define MH_CLEANUP 4
typedef struct tagMONERRSTRUCT { UINT cb; UINT wLastError; DWORD dwTime; HANDLE hTask;} MONERRSTRUCT, *PMONERRSTRUCT;
typedef struct tagMONLINKSTRUCT { UINT cb; DWORD dwTime; HANDLE hTask; BOOL fEstablished; BOOL fNoData; HSZ hszSvc; HSZ hszTopic; HSZ hszItem; UINT wFmt; BOOL fServer; HCONV hConvServer; HCONV hConvClient;} MONLINKSTRUCT, *PMONLINKSTRUCT;
typedef struct tagMONCONVSTRUCT { UINT cb; BOOL fConnect; DWORD dwTime; HANDLE hTask; HSZ hszSvc; HSZ hszTopic; HCONV hConvClient; // Globally unique value != apps local hConv HCONV hConvServer; // Globally unique value != apps local hConv} MONCONVSTRUCT, *PMONCONVSTRUCT;
#define MAX_MONITORS 4#define APPCLASS_MONITOR 0x00000001L#define XTYP_MONITOR (0x00F0 | XCLASS_NOTIFICATION | XTYPF_NOBLOCK)
/* * 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#endif /* NODDEMLSPY */
#ifdef __cplusplus}#endif /* __cplusplus */
#endif /* _INC_DDEMLH */
;begin_internal
#ifdef __cplusplus}#endif /* __cplusplus */
#endif /* _INC_DDEMLPH */;end_internal
|
