home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / vc98 / include / ole.h < prev    next >
C/C++ Source or Header  |  1998-04-25  |  26KB  |  504 lines
  1. /*****************************************************************************\
  2. *                                                                             *
  3. * ole.h -       Object Linking and Embedding functions, types, and definitions*
  4. *                                                                             *
  5. *               Version 1.0                                                   *
  6. *                                                                             *
  7. *               NOTE: windows.h must be #included first                       *
  8. *                                                                             *
  9. *               Copyright (c) 1990-1996, Microsoft Corp.  All rights reserved.*
  10. *                                                                             *
  11. \*****************************************************************************/
  12.  
  13. #ifndef _INC_OLE
  14. #define _INC_OLE
  15.  
  16. #ifdef WIN16
  17. #include <pshpack1.h>   /* Assume byte packing throughout */
  18. #endif
  19.  
  20. #ifdef __cplusplus
  21. extern "C" {            /* Assume C declarations for C++ */
  22. #endif  /* __cplusplus */
  23.  
  24. #ifndef WINAPI          /* If not included with 3.1 headers... */
  25. #define WINAPI      FAR PASCAL
  26. #define CALLBACK    FAR PASCAL
  27. #define LPCSTR      LPSTR
  28. #define LRESULT     LONG
  29. #define HGLOBAL     HANDLE
  30. #endif  /* _INC_WINDOWS */
  31.  
  32.  
  33. #ifdef STRICT
  34. #define OLE_LPCSTR  LPCSTR
  35. #define OLE_CONST   const
  36. #else   /* STRICT */
  37. #define OLE_LPCSTR  LPSTR
  38. #define OLE_CONST
  39. #endif /* !STRICT */
  40.  
  41. #define LRESULT     LONG
  42. #define HGLOBAL     HANDLE
  43.  
  44.  
  45. /* Object types */
  46. #define OT_LINK             1L
  47. #define OT_EMBEDDED         2L
  48. #define OT_STATIC           3L
  49.  
  50. /* activate verbs */
  51. #define OLEVERB_PRIMARY     0
  52.  
  53. /* target device info structure */
  54. typedef struct _OLETARGETDEVICE
  55. {
  56.     USHORT otdDeviceNameOffset;
  57.     USHORT otdDriverNameOffset;
  58.     USHORT otdPortNameOffset;
  59.     USHORT otdExtDevmodeOffset;
  60.     USHORT otdExtDevmodeSize;
  61.     USHORT otdEnvironmentOffset;
  62.     USHORT otdEnvironmentSize;
  63.     BYTE otdData[1];
  64. } OLETARGETDEVICE;
  65. typedef OLETARGETDEVICE FAR* LPOLETARGETDEVICE;
  66.  
  67. /* flags used in some methods */
  68. #define OF_SET              0x0001
  69. #define OF_GET              0x0002
  70. #define OF_HANDLER          0x0004
  71.  
  72. /* return codes for OLE functions */
  73. typedef enum
  74. {
  75.     OLE_OK,                     /* 0   Function operated correctly             */
  76.  
  77.     OLE_WAIT_FOR_RELEASE,       /* 1   Command has been initiated, client      */
  78.                                 /*     must wait for release. keep dispatching */
  79.                                 /*     messages till OLE_RELESE in callback    */
  80.  
  81.     OLE_BUSY,                   /* 2   Tried to execute a method while another */
  82.                                 /*     method is in progress.                  */
  83.  
  84.     OLE_ERROR_PROTECT_ONLY,     /* 3   Ole APIs are called in real mode        */
  85.     OLE_ERROR_MEMORY,           /* 4   Could not alloc or lock memory          */
  86.     OLE_ERROR_STREAM,           /* 5  (OLESTREAM) stream error                 */
  87.     OLE_ERROR_STATIC,           /* 6   Non static object expected              */
  88.     OLE_ERROR_BLANK,            /* 7   Critical data missing                   */
  89.     OLE_ERROR_DRAW,             /* 8   Error while drawing                     */
  90.     OLE_ERROR_METAFILE,         /* 9   Invalid metafile                        */
  91.     OLE_ERROR_ABORT,            /* 10  Client chose to abort metafile drawing  */
  92.     OLE_ERROR_CLIPBOARD,        /* 11  Failed to get/set clipboard data        */
  93.     OLE_ERROR_FORMAT,           /* 12  Requested format is not available       */
  94.     OLE_ERROR_OBJECT,           /* 13  Not a valid object                      */
  95.     OLE_ERROR_OPTION,           /* 14  Invalid option(link update / render)    */
  96.     OLE_ERROR_PROTOCOL,         /* 15  Invalid protocol                        */
  97.     OLE_ERROR_ADDRESS,          /* 16  One of the pointers is invalid          */
  98.     OLE_ERROR_NOT_EQUAL,        /* 17  Objects are not equal                   */
  99.     OLE_ERROR_HANDLE,           /* 18  Invalid handle encountered              */
  100.     OLE_ERROR_GENERIC,          /* 19  Some general error                      */
  101.     OLE_ERROR_CLASS,            /* 20  Invalid class                           */
  102.     OLE_ERROR_SYNTAX,           /* 21  Command syntax is invalid               */
  103.     OLE_ERROR_DATATYPE,         /* 22  Data format is not supported            */
  104.     OLE_ERROR_PALETTE,          /* 23  Invalid color palette                   */
  105.     OLE_ERROR_NOT_LINK,         /* 24  Not a linked object                     */
  106.     OLE_ERROR_NOT_EMPTY,        /* 25  Client doc contains objects.            */
  107.     OLE_ERROR_SIZE,             /* 26  Incorrect buffer size passed to the api */
  108.                                 /*     that places some string in caller's     */
  109.                                 /*     buffer                                  */
  110.  
  111.     OLE_ERROR_DRIVE,            /* 27  Drive letter in doc name is invalid     */
  112.     OLE_ERROR_NETWORK,          /* 28  Failed to establish connection to a     */
  113.                                 /*     network share on which the document     */
  114.                                 /*     is located                              */
  115.  
  116.     OLE_ERROR_NAME,             /* 29  Invalid name(doc name, object name),    */
  117.                                 /*     etc.. passed to the APIs                */
  118.  
  119.     OLE_ERROR_TEMPLATE,         /* 30  Server failed to load template          */
  120.     OLE_ERROR_NEW,              /* 31  Server failed to create new doc         */
  121.     OLE_ERROR_EDIT,             /* 32  Server failed to create embedded        */
  122.                                 /*     instance                                */
  123.     OLE_ERROR_OPEN,             /* 33  Server failed to open document,         */
  124.                                 /*     possible invalid link                   */
  125.  
  126.     OLE_ERROR_NOT_OPEN,         /* 34  Object is not open for editing          */
  127.     OLE_ERROR_LAUNCH,           /* 35  Failed to launch server                 */
  128.     OLE_ERROR_COMM,             /* 36  Failed to communicate with server       */
  129.     OLE_ERROR_TERMINATE,        /* 37  Error in termination                    */
  130.     OLE_ERROR_COMMAND,          /* 38  Error in execute                        */
  131.     OLE_ERROR_SHOW,             /* 39  Error in show                           */
  132.     OLE_ERROR_DOVERB,           /* 40  Error in sending do verb, or invalid    */
  133.                                 /*     verb                                    */
  134.     OLE_ERROR_ADVISE_NATIVE,    /* 41  Item could be missing                   */
  135.     OLE_ERROR_ADVISE_PICT,      /* 42  Item could be missing or server doesn't */
  136.                                 /*     this format.                            */
  137.  
  138.     OLE_ERROR_ADVISE_RENAME,    /* 43  Server doesn't support rename           */
  139.     OLE_ERROR_POKE_NATIVE,      /* 44  Failure of poking native data to server */
  140.     OLE_ERROR_REQUEST_NATIVE,   /* 45  Server failed to render native data     */
  141.     OLE_ERROR_REQUEST_PICT,     /* 46  Server failed to render presentation    */
  142.                                 /*     data                                    */
  143.     OLE_ERROR_SERVER_BLOCKED,   /* 47  Trying to block a blocked server or     */
  144.                                 /*     trying to revoke a blocked server       */
  145.                                 /*     or document                             */
  146.  
  147.     OLE_ERROR_REGISTRATION,     /* 48  Server is not registered in regestation */
  148.                                 /*     data base                               */
  149.     OLE_ERROR_ALREADY_REGISTERED,/*49  Trying to register same doc multiple    */
  150.                                  /*    times                                   */
  151.     OLE_ERROR_TASK,             /* 50  Server or client task is invalid        */
  152.     OLE_ERROR_OUTOFDATE,        /* 51  Object is out of date                   */
  153.     OLE_ERROR_CANT_UPDATE_CLIENT,/* 52 Embed doc's client doesn't accept       */
  154.                                 /*     updates                                 */
  155.     OLE_ERROR_UPDATE,           /* 53  erorr while trying to update            */
  156.     OLE_ERROR_SETDATA_FORMAT,   /* 54  Server app doesn't understand the       */
  157.                                 /*     format given to its SetData method      */
  158.     OLE_ERROR_STATIC_FROM_OTHER_OS,/* 55 trying to load a static object created */
  159.                                    /*    on another Operating System           */
  160.     OLE_ERROR_FILE_VER,
  161.  
  162.     /*  Following are warnings */
  163.     OLE_WARN_DELETE_DATA = 1000 /*     Caller must delete the data when he is  */
  164.                                 /*     done with it.                           */
  165. } OLESTATUS;
  166.  
  167.  
  168.  
  169. /* Codes for CallBack events */
  170. typedef enum
  171. {
  172.     OLE_CHANGED,            /* 0                                             */
  173.     OLE_SAVED,              /* 1                                             */
  174.     OLE_CLOSED,             /* 2                                             */
  175.     OLE_RENAMED,            /* 3                                             */
  176.     OLE_QUERY_PAINT,        /* 4  Interruptible paint support                */
  177.     OLE_RELEASE,            /* 5  Object is released(asynchronous operation  */
  178.                             /*    is completed)                              */
  179.     OLE_QUERY_RETRY        /* 6  Query for retry when server sends busy ACK */
  180. } OLE_NOTIFICATION;
  181.  
  182. typedef enum
  183. {
  184.     OLE_NONE,               /* 0  no method active                           */
  185.     OLE_DELETE,             /* 1  object delete                              */
  186.     OLE_LNKPASTE,           /* 2  PasteLink(auto reconnect)                  */
  187.     OLE_EMBPASTE,           /* 3  paste(and update)                          */
  188.     OLE_SHOW,               /* 4  Show                                       */
  189.     OLE_RUN,                /* 5  Run                                        */
  190.     OLE_ACTIVATE,           /* 6  Activate                                   */
  191.     OLE_UPDATE,             /* 7  Update                                     */
  192.     OLE_CLOSE,              /* 8  Close                                      */
  193.     OLE_RECONNECT,          /* 9  Reconnect                                  */
  194.     OLE_SETUPDATEOPTIONS,   /* 10 setting update options                     */
  195.     OLE_SERVERUNLAUNCH,     /* 11 server is being unlaunched                 */
  196.     OLE_LOADFROMSTREAM,     /* 12 LoadFromStream(auto reconnect)             */
  197.     OLE_SETDATA,            /* 13 OleSetData                                 */
  198.     OLE_REQUESTDATA,        /* 14 OleRequestData                             */
  199.     OLE_OTHER,              /* 15 other misc async operations                */
  200.     OLE_CREATE,             /* 16 create                                     */
  201.     OLE_CREATEFROMTEMPLATE, /* 17 CreatefromTemplate                         */
  202.     OLE_CREATELINKFROMFILE, /* 18 CreateLinkFromFile                         */
  203.     OLE_COPYFROMLNK,        /* 19 CopyFromLink(auto reconnect)               */
  204.     OLE_CREATEFROMFILE,     /* 20 CreateFromFile                             */
  205.     OLE_CREATEINVISIBLE     /* 21 CreateInvisible                            */
  206. } OLE_RELEASE_METHOD;
  207.  
  208. /* rendering options */
  209. typedef enum
  210. {
  211.     olerender_none,
  212.     olerender_draw,
  213.     olerender_format
  214. } OLEOPT_RENDER;
  215.  
  216. /* standard clipboard format type */
  217. typedef WORD OLECLIPFORMAT;
  218.  
  219. /* Link update options */
  220. typedef enum
  221. {
  222.     oleupdate_always,
  223.     oleupdate_onsave,
  224. #ifdef OLE_INTERNAL
  225.     oleupdate_oncall,
  226.     oleupdate_onclose
  227. #else
  228.     oleupdate_oncall
  229. #endif  /* OLE_INTERNAL */
  230. } OLEOPT_UPDATE;
  231.  
  232. typedef HANDLE  HOBJECT;
  233. typedef LONG    LHSERVER;
  234. typedef LONG    LHCLIENTDOC;
  235. typedef LONG    LHSERVERDOC;
  236.  
  237. typedef struct _OLEOBJECT FAR*  LPOLEOBJECT;
  238. typedef struct _OLESTREAM FAR*  LPOLESTREAM;
  239. typedef struct _OLECLIENT FAR*  LPOLECLIENT;
  240.  
  241.  
  242. /* object method table definitions. */
  243. typedef struct _OLEOBJECTVTBL
  244. {
  245.     void FAR*      (CALLBACK* QueryProtocol)        (LPOLEOBJECT, OLE_LPCSTR);
  246.     OLESTATUS      (CALLBACK* Release)              (LPOLEOBJECT);
  247.     OLESTATUS      (CALLBACK* Show)                 (LPOLEOBJECT, BOOL);
  248.     OLESTATUS      (CALLBACK* DoVerb)               (LPOLEOBJECT, UINT, BOOL, BOOL);
  249.     OLESTATUS      (CALLBACK* GetData)              (LPOLEOBJECT, OLECLIPFORMAT, HANDLE FAR*);
  250.     OLESTATUS      (CALLBACK* SetData)              (LPOLEOBJECT, OLECLIPFORMAT, HANDLE);
  251.     OLESTATUS      (CALLBACK* SetTargetDevice)      (LPOLEOBJECT, HGLOBAL);
  252.     OLESTATUS      (CALLBACK* SetBounds)            (LPOLEOBJECT, OLE_CONST RECT FAR*);
  253.     OLECLIPFORMAT  (CALLBACK* EnumFormats)          (LPOLEOBJECT, OLECLIPFORMAT);
  254.     OLESTATUS      (CALLBACK* SetColorScheme)       (LPOLEOBJECT, OLE_CONST LOGPALETTE FAR*);
  255.     /* Server has to implement only the above methods. */
  256.  
  257. #ifndef SERVERONLY
  258.     /* Extra methods required for client. */
  259.     OLESTATUS      (CALLBACK* Delete)               (LPOLEOBJECT);
  260.     OLESTATUS      (CALLBACK* SetHostNames)         (LPOLEOBJECT, OLE_LPCSTR, OLE_LPCSTR);
  261.     OLESTATUS      (CALLBACK* SaveToStream)         (LPOLEOBJECT, LPOLESTREAM);
  262.     OLESTATUS      (CALLBACK* Clone)                (LPOLEOBJECT, LPOLECLIENT, LHCLIENTDOC, OLE_LPCSTR, LPOLEOBJECT FAR*);
  263.     OLESTATUS      (CALLBACK* CopyFromLink)         (LPOLEOBJECT, LPOLECLIENT, LHCLIENTDOC, OLE_LPCSTR, LPOLEOBJECT FAR*);
  264.     OLESTATUS      (CALLBACK* Equal)                (LPOLEOBJECT, LPOLEOBJECT);
  265.     OLESTATUS      (CALLBACK* CopyToClipboard)      (LPOLEOBJECT);
  266.     OLESTATUS      (CALLBACK* Draw)                 (LPOLEOBJECT, HDC, OLE_CONST RECT FAR*, OLE_CONST RECT FAR*, HDC);
  267.     OLESTATUS      (CALLBACK* Activate)             (LPOLEOBJECT, UINT, BOOL, BOOL, HWND, OLE_CONST RECT FAR*);
  268.     OLESTATUS      (CALLBACK* Execute)              (LPOLEOBJECT, HGLOBAL, UINT);
  269.     OLESTATUS      (CALLBACK* Close)                (LPOLEOBJECT);
  270.     OLESTATUS      (CALLBACK* Update)               (LPOLEOBJECT);
  271.     OLESTATUS      (CALLBACK* Reconnect)            (LPOLEOBJECT);
  272.  
  273.     OLESTATUS      (CALLBACK* ObjectConvert)        (LPOLEOBJECT, OLE_LPCSTR, LPOLECLIENT, LHCLIENTDOC, OLE_LPCSTR, LPOLEOBJECT FAR*);
  274.     OLESTATUS      (CALLBACK* GetLinkUpdateOptions) (LPOLEOBJECT, OLEOPT_UPDATE FAR*);
  275.     OLESTATUS      (CALLBACK* SetLinkUpdateOptions) (LPOLEOBJECT, OLEOPT_UPDATE);
  276.  
  277.     OLESTATUS      (CALLBACK* Rename)               (LPOLEOBJECT, OLE_LPCSTR);
  278.     OLESTATUS      (CALLBACK* QueryName)            (LPOLEOBJECT, LPSTR, UINT FAR*);
  279.  
  280.     OLESTATUS      (CALLBACK* QueryType)            (LPOLEOBJECT, LONG FAR*);
  281.     OLESTATUS      (CALLBACK* QueryBounds)          (LPOLEOBJECT, RECT FAR*);
  282.     OLESTATUS      (CALLBACK* QuerySize)            (LPOLEOBJECT, DWORD FAR*);
  283.     OLESTATUS      (CALLBACK* QueryOpen)            (LPOLEOBJECT);
  284.     OLESTATUS      (CALLBACK* QueryOutOfDate)       (LPOLEOBJECT);
  285.  
  286.     OLESTATUS      (CALLBACK* QueryReleaseStatus)   (LPOLEOBJECT);
  287.     OLESTATUS      (CALLBACK* QueryReleaseError)    (LPOLEOBJECT);
  288.     OLE_RELEASE_METHOD (CALLBACK* QueryReleaseMethod)(LPOLEOBJECT);
  289.  
  290.     OLESTATUS      (CALLBACK* RequestData)          (LPOLEOBJECT, OLECLIPFORMAT);
  291.     OLESTATUS      (CALLBACK* ObjectLong)           (LPOLEOBJECT, UINT, LONG FAR*);
  292.  
  293. /* This method is internal only */
  294.     OLESTATUS      (CALLBACK* ChangeData)           (LPOLEOBJECT, HANDLE, LPOLECLIENT, BOOL);
  295. #endif  /* !SERVERONLY */
  296. } OLEOBJECTVTBL;
  297. typedef  OLEOBJECTVTBL FAR* LPOLEOBJECTVTBL;
  298.  
  299. #ifndef OLE_INTERNAL
  300. typedef struct _OLEOBJECT
  301. {
  302.     LPOLEOBJECTVTBL    lpvtbl;
  303. } OLEOBJECT;
  304. #endif
  305.  
  306. /* ole client definitions */
  307. typedef struct _OLECLIENTVTBL
  308. {
  309.     int (CALLBACK* CallBack)(LPOLECLIENT, OLE_NOTIFICATION, LPOLEOBJECT);
  310. } OLECLIENTVTBL;
  311.  
  312. typedef  OLECLIENTVTBL FAR*  LPOLECLIENTVTBL;
  313.  
  314. typedef struct _OLECLIENT
  315. {
  316.     LPOLECLIENTVTBL   lpvtbl;
  317. } OLECLIENT;
  318.  
  319. /* Stream definitions */
  320. typedef struct _OLESTREAMVTBL
  321. {
  322.     DWORD (CALLBACK* Get)(LPOLESTREAM, void FAR*, DWORD);
  323.     DWORD (CALLBACK* Put)(LPOLESTREAM, OLE_CONST void FAR*, DWORD);
  324. } OLESTREAMVTBL;
  325. typedef  OLESTREAMVTBL FAR*  LPOLESTREAMVTBL;
  326.  
  327. typedef struct _OLESTREAM
  328. {
  329.     LPOLESTREAMVTBL      lpstbl;
  330. } OLESTREAM;
  331.  
  332. /* Public Function Prototypes */
  333. OLESTATUS   WINAPI  OleDelete(LPOLEOBJECT);
  334. OLESTATUS   WINAPI  OleRelease(LPOLEOBJECT);
  335. OLESTATUS   WINAPI  OleSaveToStream(LPOLEOBJECT, LPOLESTREAM);
  336. OLESTATUS   WINAPI  OleEqual(LPOLEOBJECT, LPOLEOBJECT );
  337. OLESTATUS   WINAPI  OleCopyToClipboard(LPOLEOBJECT);
  338. OLESTATUS   WINAPI  OleSetHostNames(LPOLEOBJECT, LPCSTR, LPCSTR);
  339. OLESTATUS   WINAPI  OleSetTargetDevice(LPOLEOBJECT, HGLOBAL);
  340. OLESTATUS   WINAPI  OleSetBounds(LPOLEOBJECT, const RECT FAR*);
  341. OLESTATUS   WINAPI  OleSetColorScheme(LPOLEOBJECT, const LOGPALETTE FAR*);
  342. OLESTATUS   WINAPI  OleQueryBounds(LPOLEOBJECT, RECT FAR*);
  343. OLESTATUS   WINAPI  OleQuerySize(LPOLEOBJECT, DWORD FAR*);
  344. OLESTATUS   WINAPI  OleDraw(LPOLEOBJECT, HDC, const RECT FAR*, const RECT FAR*, HDC);
  345. OLESTATUS   WINAPI  OleQueryOpen(LPOLEOBJECT);
  346. OLESTATUS   WINAPI  OleActivate(LPOLEOBJECT, UINT, BOOL, BOOL, HWND, const RECT FAR*);
  347. OLESTATUS   WINAPI  OleExecute(LPOLEOBJECT, HGLOBAL, UINT);
  348. OLESTATUS   WINAPI  OleClose(LPOLEOBJECT);
  349. OLESTATUS   WINAPI  OleUpdate(LPOLEOBJECT);
  350. OLESTATUS   WINAPI  OleReconnect(LPOLEOBJECT);
  351. OLESTATUS   WINAPI  OleGetLinkUpdateOptions(LPOLEOBJECT, OLEOPT_UPDATE FAR*);
  352. OLESTATUS   WINAPI  OleSetLinkUpdateOptions(LPOLEOBJECT, OLEOPT_UPDATE);
  353. void FAR*   WINAPI  OleQueryProtocol(LPOLEOBJECT, LPCSTR);
  354.  
  355. /* Routines related to asynchronous operations. */
  356. OLESTATUS   WINAPI  OleQueryReleaseStatus(LPOLEOBJECT);
  357. OLESTATUS   WINAPI  OleQueryReleaseError(LPOLEOBJECT);
  358. OLE_RELEASE_METHOD WINAPI OleQueryReleaseMethod(LPOLEOBJECT);
  359.  
  360. OLESTATUS   WINAPI  OleQueryType(LPOLEOBJECT, LONG FAR*);
  361.  
  362. /* LOWORD is major version, HIWORD is minor version */
  363. DWORD       WINAPI  OleQueryClientVersion(void);
  364. DWORD       WINAPI  OleQueryServerVersion(void);
  365.  
  366. /* Converting to format (as in clipboard): */
  367. OLECLIPFORMAT  WINAPI  OleEnumFormats(LPOLEOBJECT, OLECLIPFORMAT);
  368. OLESTATUS   WINAPI  OleGetData(LPOLEOBJECT, OLECLIPFORMAT, HANDLE FAR*);
  369. OLESTATUS   WINAPI  OleSetData(LPOLEOBJECT, OLECLIPFORMAT, HANDLE);
  370. OLESTATUS   WINAPI  OleQueryOutOfDate(LPOLEOBJECT);
  371. OLESTATUS   WINAPI  OleRequestData(LPOLEOBJECT, OLECLIPFORMAT);
  372.  
  373. /* Query apis for creation from clipboard */
  374. OLESTATUS   WINAPI  OleQueryLinkFromClip(LPCSTR, OLEOPT_RENDER, OLECLIPFORMAT);
  375. OLESTATUS   WINAPI  OleQueryCreateFromClip(LPCSTR, OLEOPT_RENDER, OLECLIPFORMAT);
  376.  
  377. /* Object creation functions */
  378. OLESTATUS   WINAPI  OleCreateFromClip(LPCSTR, LPOLECLIENT, LHCLIENTDOC, LPCSTR,  LPOLEOBJECT FAR*, OLEOPT_RENDER, OLECLIPFORMAT);
  379. OLESTATUS   WINAPI  OleCreateLinkFromClip(LPCSTR, LPOLECLIENT, LHCLIENTDOC, LPCSTR, LPOLEOBJECT FAR*, OLEOPT_RENDER, OLECLIPFORMAT);
  380. OLESTATUS   WINAPI  OleCreateFromFile(LPCSTR, LPOLECLIENT, LPCSTR, LPCSTR, LHCLIENTDOC, LPCSTR, LPOLEOBJECT FAR*, OLEOPT_RENDER, OLECLIPFORMAT);
  381. OLESTATUS   WINAPI  OleCreateLinkFromFile(LPCSTR, LPOLECLIENT, LPCSTR, LPCSTR, LPCSTR, LHCLIENTDOC, LPCSTR, LPOLEOBJECT FAR*, OLEOPT_RENDER, OLECLIPFORMAT);
  382. OLESTATUS   WINAPI  OleLoadFromStream(LPOLESTREAM, LPCSTR, LPOLECLIENT, LHCLIENTDOC, LPCSTR, LPOLEOBJECT FAR*);
  383. OLESTATUS   WINAPI  OleCreate(LPCSTR, LPOLECLIENT, LPCSTR, LHCLIENTDOC, LPCSTR, LPOLEOBJECT FAR*, OLEOPT_RENDER, OLECLIPFORMAT);
  384. OLESTATUS   WINAPI  OleCreateInvisible(LPCSTR, LPOLECLIENT, LPCSTR, LHCLIENTDOC, LPCSTR, LPOLEOBJECT FAR*, OLEOPT_RENDER, OLECLIPFORMAT, BOOL);
  385. OLESTATUS   WINAPI  OleCreateFromTemplate(LPCSTR, LPOLECLIENT, LPCSTR, LHCLIENTDOC, LPCSTR, LPOLEOBJECT FAR*, OLEOPT_RENDER, OLECLIPFORMAT);
  386. OLESTATUS   WINAPI  OleClone(LPOLEOBJECT, LPOLECLIENT, LHCLIENTDOC, LPCSTR, LPOLEOBJECT FAR*);
  387. OLESTATUS   WINAPI  OleCopyFromLink(LPOLEOBJECT, LPCSTR, LPOLECLIENT, LHCLIENTDOC, LPCSTR, LPOLEOBJECT FAR*);
  388. OLESTATUS   WINAPI  OleObjectConvert(LPOLEOBJECT, LPCSTR, LPOLECLIENT, LHCLIENTDOC, LPCSTR, LPOLEOBJECT FAR*);
  389. OLESTATUS   WINAPI  OleRename(LPOLEOBJECT, LPCSTR);
  390. OLESTATUS   WINAPI  OleQueryName(LPOLEOBJECT, LPSTR, UINT FAR*);
  391. OLESTATUS   WINAPI  OleRevokeObject(LPOLECLIENT);
  392. BOOL        WINAPI  OleIsDcMeta(HDC);
  393.  
  394. /* client document API */
  395. OLESTATUS   WINAPI  OleRegisterClientDoc(LPCSTR, LPCSTR, LONG, LHCLIENTDOC FAR*);
  396. OLESTATUS   WINAPI  OleRevokeClientDoc(LHCLIENTDOC);
  397. OLESTATUS   WINAPI  OleRenameClientDoc(LHCLIENTDOC, LPCSTR);
  398. OLESTATUS   WINAPI  OleRevertClientDoc(LHCLIENTDOC);
  399. OLESTATUS   WINAPI  OleSavedClientDoc(LHCLIENTDOC);
  400. OLESTATUS   WINAPI  OleEnumObjects(LHCLIENTDOC, LPOLEOBJECT FAR*);
  401.  
  402. /* server usage definitions */
  403. typedef enum {
  404.     OLE_SERVER_MULTI,           /* multiple instances */
  405.     OLE_SERVER_SINGLE           /* single instance(multiple document) */
  406. } OLE_SERVER_USE;
  407.  
  408. /* Server API */
  409. typedef struct _OLESERVER FAR*  LPOLESERVER;
  410.  
  411. OLESTATUS   WINAPI  OleRegisterServer(LPCSTR, LPOLESERVER, LHSERVER FAR*, HINSTANCE, OLE_SERVER_USE);
  412. OLESTATUS   WINAPI  OleRevokeServer(LHSERVER);
  413. OLESTATUS   WINAPI  OleBlockServer(LHSERVER);
  414. OLESTATUS   WINAPI  OleUnblockServer(LHSERVER, BOOL FAR*);
  415.  
  416. /* APIs to keep server open */
  417. OLESTATUS   WINAPI  OleLockServer(LPOLEOBJECT, LHSERVER FAR*);
  418. OLESTATUS   WINAPI  OleUnlockServer(LHSERVER);
  419.  
  420. /* Server document API */
  421.  
  422. typedef struct _OLESERVERDOC FAR*  LPOLESERVERDOC;
  423.  
  424. OLESTATUS   WINAPI  OleRegisterServerDoc(LHSERVER, LPCSTR, LPOLESERVERDOC, LHSERVERDOC FAR*);
  425. OLESTATUS   WINAPI  OleRevokeServerDoc(LHSERVERDOC);
  426. OLESTATUS   WINAPI  OleRenameServerDoc(LHSERVERDOC, LPCSTR);
  427. OLESTATUS   WINAPI  OleRevertServerDoc(LHSERVERDOC);
  428. OLESTATUS   WINAPI  OleSavedServerDoc(LHSERVERDOC);
  429.  
  430. typedef struct _OLESERVERVTBL
  431. {
  432.     OLESTATUS (CALLBACK* Open)  (LPOLESERVER, LHSERVERDOC, OLE_LPCSTR, LPOLESERVERDOC FAR*);
  433.                                     /* long handle to doc(privtate to DLL)  */
  434.                                     /* lp to OLESERVER                      */
  435.                                     /* document name                        */
  436.                                     /* place holder for returning oledoc.   */
  437.  
  438.     OLESTATUS (CALLBACK* Create)(LPOLESERVER, LHSERVERDOC, OLE_LPCSTR, OLE_LPCSTR, LPOLESERVERDOC FAR*);
  439.                                     /* long handle to doc(privtate to DLL)  */
  440.                                     /* lp to OLESERVER                      */
  441.                                     /* lp class name                        */
  442.                                     /* lp doc name                          */
  443.                                     /* place holder for returning oledoc.   */
  444.  
  445.     OLESTATUS (CALLBACK* CreateFromTemplate)(LPOLESERVER, LHSERVERDOC, OLE_LPCSTR, OLE_LPCSTR, OLE_LPCSTR, LPOLESERVERDOC FAR*);
  446.                                     /* long handle to doc(privtate to DLL)  */
  447.                                     /* lp to OLESERVER                      */
  448.                                     /* lp class name                        */
  449.                                     /* lp doc name                          */
  450.                                     /* lp template name                     */
  451.                                     /* place holder for returning oledoc.   */
  452.  
  453.     OLESTATUS (CALLBACK* Edit)  (LPOLESERVER, LHSERVERDOC, OLE_LPCSTR, OLE_LPCSTR, LPOLESERVERDOC FAR*);
  454.                                     /* long handle to doc(privtate to DLL)  */
  455.                                     /* lp to OLESERVER                      */
  456.                                     /* lp class name                        */
  457.                                     /* lp doc name                          */
  458.                                     /* place holder for returning oledoc.   */
  459.  
  460.     OLESTATUS (CALLBACK* Exit)  (LPOLESERVER);
  461.                                     /* lp OLESERVER                         */
  462.  
  463.     OLESTATUS (CALLBACK* Release)  (LPOLESERVER);
  464.                                     /* lp OLESERVER                         */
  465.  
  466.     OLESTATUS (CALLBACK* Execute)(LPOLESERVER, HGLOBAL);
  467.                                     /* lp OLESERVER                         */
  468.                                     /* handle to command strings            */
  469. } OLESERVERVTBL;
  470. typedef  OLESERVERVTBL FAR*  LPOLESERVERVTBL;
  471.  
  472. typedef struct _OLESERVER
  473. {
  474.     LPOLESERVERVTBL    lpvtbl;
  475. } OLESERVER;
  476.  
  477. typedef struct _OLESERVERDOCVTBL
  478. {
  479.     OLESTATUS (CALLBACK* Save)      (LPOLESERVERDOC);
  480.     OLESTATUS (CALLBACK* Close)     (LPOLESERVERDOC);
  481.     OLESTATUS (CALLBACK* SetHostNames)(LPOLESERVERDOC, OLE_LPCSTR, OLE_LPCSTR);
  482.     OLESTATUS (CALLBACK* SetDocDimensions)(LPOLESERVERDOC, OLE_CONST RECT FAR*);
  483.     OLESTATUS (CALLBACK* GetObject) (LPOLESERVERDOC, OLE_LPCSTR, LPOLEOBJECT FAR*, LPOLECLIENT);
  484.     OLESTATUS (CALLBACK* Release)   (LPOLESERVERDOC);
  485.     OLESTATUS (CALLBACK* SetColorScheme)(LPOLESERVERDOC, OLE_CONST LOGPALETTE FAR*);
  486.     OLESTATUS (CALLBACK* Execute)  (LPOLESERVERDOC, HGLOBAL);
  487. } OLESERVERDOCVTBL;
  488. typedef  OLESERVERDOCVTBL FAR*  LPOLESERVERDOCVTBL;
  489.  
  490. typedef struct _OLESERVERDOC
  491. {
  492.     LPOLESERVERDOCVTBL lpvtbl;
  493. } OLESERVERDOC;
  494.  
  495. #ifdef __cplusplus
  496. }
  497. #endif  /* __cplusplus */
  498.  
  499. #ifdef WIN16
  500. #include <poppack.h>
  501. #endif
  502.  
  503. #endif  /* !_INC_OLE */
  504.