home *** CD-ROM | disk | FTP | other *** search
/ Chip 1997 September / CHIP_CD_1997_09_PL.iso / software / testsoft / labwind / demo.6 / main / include / ddesupp.h < prev    next >
Encoding:
C/C++ Source or Header  |  1996-08-02  |  5.3 KB  |  136 lines
  1. /*============================================================================*/
  2. /*                        L a b W i n d o w s / C V I                         */
  3. /*----------------------------------------------------------------------------*/
  4. /*    Copyright (c) National Instruments 1987-1996.  All Rights Reserved.     */
  5. /*----------------------------------------------------------------------------*/
  6. /*                                                                            */
  7. /* Title:       ddesupp.h                                                     */
  8. /* Purpose:     Include file for Windows (TM) DDE support library.            */
  9. /*                                                                            */
  10. /*============================================================================*/
  11.  
  12.  
  13. #ifndef DDESUPP_HEADER
  14. #define DDESUPP_HEADER
  15.  
  16. #include "cvidef.h"
  17. #include "cvirte.h"
  18.  
  19. #ifdef __cplusplus
  20.     extern "C" {
  21. #endif
  22.  
  23. /* constants */
  24.  
  25. #define DDE_CONNECT         1
  26. #define DDE_DISCONNECT      2
  27. #define DDE_DATAREADY       3
  28. #define DDE_REQUESTDATA     4
  29. #define DDE_ADVISELOOP      5
  30. #define DDE_ADVISESTOP      6
  31. #define DDE_EXECUTE         7
  32.  
  33. /* Windows provides serveral predefined formats for use in data interchange */
  34.  
  35. #define CF_TEXT             1
  36. #define CF_BITMAP           2
  37. #define CF_METAFILEPICT     3
  38. #define CF_SYLK             4
  39. #define CF_DIF              5
  40. #define CF_TIFF             6
  41. #define CF_OEMTEXT          7
  42. #define CF_DIB              8
  43. #define CF_PALETTE          9
  44. #define CF_PENDATA          10
  45. #define CF_RIFF             11
  46. #define CF_WAVE             12
  47.  
  48. #define CF_OWNERDISPLAY     0x0080
  49. #define CF_DSPTEXT          0x0081
  50. #define CF_DSPBITMAP        0x0082
  51. #define CF_DSPMETAFILEPICT  0x0083
  52.  
  53. /* enumerated errors */
  54.  
  55. enum ddeError {
  56.     kDDE_NoError,
  57.     kDDE_UnableToRegisterService,
  58.     kDDE_ExistingServer,
  59.     kDDE_FailedToConnect,
  60.     kDDE_ServerNotRegistered,
  61.     kDDE_TooManyConversations,
  62.     kDDE_ReadFailed,
  63.     kDDE_WriteFailed,
  64.     kDDE_ExecutionFailed,
  65.     kDDE_InvalidParameter,
  66.     kDDE_OutOfMemory,
  67.     kDDE_TimeOutErr,
  68.     kDDE_NoConnectionEstablished,
  69.     kDDE_FailedToSetUpHotLink,
  70.     kDDE_FailedToSetUpWarmLink,
  71.     kDDE_GeneralIOErr,
  72.  
  73.     kDDE_AdvAckTimeOut,              
  74.     kDDE_Busy,                        
  75.     kDDE_DataAckTimeOut,            
  76.     kDDE_DllNotInitialized,        
  77.     kDDE_DllUsage,                 
  78.     kDDE_ExecAckTimeOut,             
  79.     kDDE_DataMismatch,         
  80.     kDDE_LowMemory,                 
  81.     kDDE_MemoryError,             
  82.     kDDE_NotProcessed,               
  83.     kDDE_NoConvEstablished,        
  84.     kDDE_PokeAckTimeOut,             
  85.     kDDE_PostMsgFailed,             
  86.     kDDE_Reentrancy,                 
  87.     kDDE_ServerDied,              
  88.     kDDE_SysError,                
  89.     kDDE_UnadvAckTimeOut,           
  90.     kDDE_UnfoundQueueId          
  91. };
  92.  
  93.  
  94. /* typedefs */
  95.  
  96. typedef int (CVICALLBACK  * ddeFuncPtr) (unsigned handle, char *topicName, char *itemName,
  97.                                          int xType, int dataFmt, int dataSize,
  98.                                          void *dataPtr, void *callbackData);
  99.  
  100. /* exported functions */
  101.  
  102. int CVIFUNC AdviseDDEDataReady(unsigned convHandle, const char userItemName[],
  103.                                unsigned dataFmt, const void *userData,
  104.                                unsigned dataSize, unsigned timeOut);
  105. int CVIFUNC BroadcastDDEDataReady(const char userServName[], const char userTopicName[], 
  106.                                   const char userItemName[], unsigned dataFmt, 
  107.                                   const void *userData, unsigned dataSize);
  108. int CVIFUNC ClientDDEExecute(unsigned convHandle, const char commandString[],unsigned timeOut);
  109. int CVIFUNC ClientDDERead(unsigned convHandle, const char userItemName[], unsigned dataFmt,
  110.                           void *dataBuffer, unsigned dataSize, unsigned timeOut);
  111. int CVIFUNC ClientDDEWrite(unsigned convHandle, const char userItemName[], unsigned dataFmt,
  112.                            const void *userData, unsigned dataSize, unsigned timeOut);
  113. int CVIFUNC ConnectToDDEServer(unsigned *convHandle, const char userServName[],
  114.                                const char userTopicName[], ddeFuncPtr pUserCallback,
  115.                                void *callbackData);
  116. int CVIFUNC DisconnectFromDDEServer(unsigned convHandle);
  117. int CVIFUNC RegisterDDEServer(const char userServName[], ddeFuncPtr pUserCallback,
  118.                               void *callbackData);
  119. int CVIFUNC ServerDDEWrite(unsigned convHandle, const char userItemName[], unsigned dataFmt,
  120.                            const void *userData, unsigned dataSize, unsigned timeOut);
  121. int CVIFUNC SetUpDDEHotLink(unsigned  convHandle, const char userItemName[],
  122.                             unsigned dataFmt, unsigned timeOut);
  123. int CVIFUNC SetUpDDEWarmLink(unsigned convHandle, const char userItemName[],
  124.                              unsigned dataFmt, unsigned timeOut);
  125. int CVIFUNC TerminateDDELink(unsigned convHandle, const char userItemName[],
  126.                              unsigned dataFmt, unsigned timeOut);
  127. int CVIFUNC UnregisterDDEServer(const char userServName[]);
  128.  
  129. char * CVIFUNC GetDDEErrorString(int errorNum);
  130.  
  131. #ifdef __cplusplus
  132.     }
  133. #endif
  134.  
  135. #endif /* DDESUPP_HEADER */
  136.