开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 游戏 > 模拟服务器 > 查看源码
UPnP.Idl
资源名称：SwordOnline.rar　[点击查看]
上传用户：dzyhzl
上传日期：2019-04-29
资源大小：56270k
文件大小：20k
源码类别：

模拟服务器

开发平台：

C/C++

UPnP.Idl：源码内容
  1. //+---------------------------------------------------------------------------
  2. //
  3. //  Microsoft Windows
  4. //  Copyright (c) Microsoft Corporation. All rights reserved.
  5. //
  6. //  File: upnp.idl
  7. //
  8. //----------------------------------------------------------------------------
  10. cpp_quote("//+-------------------------------------------------------------------------")
  11. cpp_quote("//")
  12. cpp_quote("//  Microsoft Windows")
  13. cpp_quote("//  Copyright (c) Microsoft Corporation. All rights reserved.")
  14. cpp_quote("//")
  15. cpp_quote("//--------------------------------------------------------------------------")
  18. #include <idispids.h>
  20. import "oaidl.idl";
  21. import "ocidl.idl";
  23. #define __UPNP_IDL_DEFINE__
  25. interface IUPnPDeviceFinder;
  26. interface IUPnPDeviceFinderCallback;
  27. interface IUPnPDevice;
  28. interface IUPnPDevices;
  29. interface IUPnPDeviceDocumentAccess;
  30. interface IUPnPService;
  31. interface IUPnPServices;
  32. interface IUPnPDevices;
  33. interface IUPnPDescriptionDocument;
  34. interface IUPnPDescriptionDocumentCallback;
  35. interface IUPnPDeviceHostSetup;
  37. cpp_quote("#define UPNP_E_ROOT_ELEMENT_EXPECTED     MAKE_HRESULT(SEVERITY_ERROR, FACILITY_ITF, 0x0200)")
  38. cpp_quote("#define UPNP_E_DEVICE_ELEMENT_EXPECTED   MAKE_HRESULT(SEVERITY_ERROR, FACILITY_ITF, 0x0201)")
  39. cpp_quote("#define UPNP_E_SERVICE_ELEMENT_EXPECTED  MAKE_HRESULT(SEVERITY_ERROR, FACILITY_ITF, 0x0202)")
  40. cpp_quote("#define UPNP_E_SERVICE_NODE_INCOMPLETE   MAKE_HRESULT(SEVERITY_ERROR, FACILITY_ITF, 0x0203)")
  41. cpp_quote("#define UPNP_E_DEVICE_NODE_INCOMPLETE    MAKE_HRESULT(SEVERITY_ERROR, FACILITY_ITF, 0x0204)")
  42. cpp_quote("#define UPNP_E_ICON_ELEMENT_EXPECTED     MAKE_HRESULT(SEVERITY_ERROR, FACILITY_ITF, 0x0205)")
  43. cpp_quote("#define UPNP_E_ICON_NODE_INCOMPLETE      MAKE_HRESULT(SEVERITY_ERROR, FACILITY_ITF, 0x0206)")
  45. cpp_quote("#define UPNP_E_INVALID_ACTION            MAKE_HRESULT(SEVERITY_ERROR, FACILITY_ITF, 0x0207)")
  46. cpp_quote("#define UPNP_E_INVALID_ARGUMENTS         MAKE_HRESULT(SEVERITY_ERROR, FACILITY_ITF, 0x0208)")
  47. cpp_quote("#define UPNP_E_OUT_OF_SYNC               MAKE_HRESULT(SEVERITY_ERROR, FACILITY_ITF, 0x0209)")
  48. cpp_quote("#define UPNP_E_ACTION_REQUEST_FAILED     MAKE_HRESULT(SEVERITY_ERROR, FACILITY_ITF, 0x0210)")
  49. cpp_quote("#define UPNP_E_TRANSPORT_ERROR           MAKE_HRESULT(SEVERITY_ERROR, FACILITY_ITF, 0x0211)")
  50. cpp_quote("#define UPNP_E_VARIABLE_VALUE_UNKNOWN    MAKE_HRESULT(SEVERITY_ERROR, FACILITY_ITF, 0x0212)")
  51. cpp_quote("#define UPNP_E_INVALID_VARIABLE          MAKE_HRESULT(SEVERITY_ERROR, FACILITY_ITF, 0x0213)")
  52. cpp_quote("#define UPNP_E_DEVICE_ERROR              MAKE_HRESULT(SEVERITY_ERROR, FACILITY_ITF, 0x0214)")
  53. cpp_quote("#define UPNP_E_PROTOCOL_ERROR            MAKE_HRESULT(SEVERITY_ERROR, FACILITY_ITF, 0x0215)")
  54. cpp_quote("#define UPNP_E_ERROR_PROCESSING_RESPONSE MAKE_HRESULT(SEVERITY_ERROR, FACILITY_ITF, 0x0216)")
  55. cpp_quote("#define UPNP_E_DEVICE_TIMEOUT            MAKE_HRESULT(SEVERITY_ERROR, FACILITY_ITF, 0x0217)")
  57. cpp_quote("#define UPNP_E_INVALID_DOCUMENT          MAKE_HRESULT(SEVERITY_ERROR, FACILITY_ITF, 0x0500)")
  58. cpp_quote("#define UPNP_E_EVENT_SUBSCRIPTION_FAILED MAKE_HRESULT(SEVERITY_ERROR, FACILITY_ITF, 0x0501)")
  60. cpp_quote("#define FAULT_INVALID_ACTION             401")
  61. cpp_quote("#define FAULT_INVALID_ARG                402")
  62. cpp_quote("#define FAULT_INVALID_SEQUENCE_NUMBER    403")
  63. cpp_quote("#define FAULT_INVALID_VARIABLE           404")
  64. cpp_quote("#define FAULT_DEVICE_INTERNAL_ERROR      501")
  65. cpp_quote("#define FAULT_ACTION_SPECIFIC_BASE       600")
  66. cpp_quote("#define FAULT_ACTION_SPECIFIC_MAX        899")
  68. // NOTE: Do not define any HRESULTs within the range
  69. // UPNP_E_ACTION_SPECIFIC_BASE - UPNP_E_ACTION_SPECIFIC_MAX.
  71. cpp_quote("#define UPNP_E_ACTION_SPECIFIC_BASE      MAKE_HRESULT(SEVERITY_ERROR, FACILITY_ITF, 0x0300)")
  72. cpp_quote("#define UPNP_E_ACTION_SPECIFIC_MAX       (UPNP_E_ACTION_SPECIFIC_BASE + (FAULT_ACTION_SPECIFIC_MAX - FAULT_ACTION_SPECIFIC_BASE))")
  74. #define DISPID_XOBJ_MIN                 0x60020000
  75. #define DISPID_XOBJ_MAX                 0x6002FFFF
  76. #define DISPID_XOBJ_BASE                DISPID_XOBJ_MIN
  78. #define DISPID_UPNPFINDDEVICES          (DISPID_XOBJ_BASE               + 1000)
  79. #define DISPID_UPNPFINDDEVICESCALLBACK  (DISPID_UPNPFINDDEVICES         + 500)
  80. #define DISPID_UPNPSERVICES             (DISPID_UPNPFINDDEVICESCALLBACK + 500)
  81. #define DISPID_UPNPSERVICE              (DISPID_UPNPSERVICES            + 500)
  82. #define DISPID_UPNPDEVICES              (DISPID_UPNPSERVICE             + 1000)
  83. #define DISPID_UPNPDEVICE               (DISPID_UPNPDEVICES             + 500)
  84. #define DISPID_UPNPDESCRIPTIONDOC       (DISPID_UPNPDEVICE              + 500)
  86. #define DISPID_UPNPFINDDEVICES_FINDBYTYPE        (DISPID_UPNPFINDDEVICES + 1)
  87. #define DISPID_UPNPFINDDEVICES_FINDBYDCPI        (DISPID_UPNPFINDDEVICES + 2)
  88. #define DISPID_UPNPFINDDEVICES_FINDBYUDN         (DISPID_UPNPFINDDEVICES + 3)
  89. #define DISPID_UPNPFINDDEVICES_CREATEASYNCFIND   (DISPID_UPNPFINDDEVICES + 4)
  90. #define DISPID_UPNPFINDDEVICES_STARTASYNCFIND    (DISPID_UPNPFINDDEVICES + 5)
  91. #define DISPID_UPNPFINDDEVICES_CANCELASYNCFIND   (DISPID_UPNPFINDDEVICES + 6)
  93. #define DISPID_UPNPFINDDEVICESCALLBACK_NEWDEVICE        (DISPID_UPNPFINDDEVICESCALLBACK + 1)
  94. #define DISPID_UPNPFINDDEVICESCALLBACK_SEARCHCOMPLETE   (DISPID_UPNPFINDDEVICESCALLBACK + 2)
  96. #define DISPID_UPNPSERVICES_COUNT                (DISPID_UPNPSERVICES + 1)
  98. #define DISPID_UPNPSERVICE_QUERYSTATEVARIABLE    (DISPID_UPNPSERVICE  + 1)
  99. #define DISPID_UPNPSERVICE_INVOKEACTION          (DISPID_UPNPSERVICE  + 2)
  100. #define DISPID_UPNPSERVICE_SERVICETYPEIDENTIFIER (DISPID_UPNPSERVICE  + 3)
  101. #define DISPID_UPNPSERVICE_ADDSTATECHANGECALLBACK   (DISPID_UPNPSERVICE  + 4)
  102. #define DISPID_UPNPSERVICE_SERVICEID             (DISPID_UPNPSERVICE  + 5)
  103. #define DISPID_UPNPSERVICE_LASTTRANSPORTSTATUS   (DISPID_UPNPSERVICE  + 6)
  105. #define DISPID_UPNPDEVICES_COUNT                 (DISPID_UPNPDEVICES  + 1)
  107. #define DISPID_UPNPDEVICE_ISROOTDEVICE           (DISPID_UPNPDEVICE   + 1)
  108. #define DISPID_UPNPDEVICE_ROOT                   (DISPID_UPNPDEVICE   + 2)
  109. #define DISPID_UPNPDEVICE_PARENT                 (DISPID_UPNPDEVICE   + 3)
  110. #define DISPID_UPNPDEVICE_HASCHILDREN            (DISPID_UPNPDEVICE   + 4)
  111. #define DISPID_UPNPDEVICE_CHILDREN               (DISPID_UPNPDEVICE   + 5)
  112. #define DISPID_UPNPDEVICE_UDN                    (DISPID_UPNPDEVICE   + 6)
  113. #define DISPID_UPNPDEVICE_FRIENDLYNAME           (DISPID_UPNPDEVICE   + 7)
  114. #define DISPID_UPNPDEVICE_DEVICETYPE             (DISPID_UPNPDEVICE   + 8)
  115. #define DISPID_UPNPDEVICE_PRESENTATIONURL        (DISPID_UPNPDEVICE   + 9)
  116. #define DISPID_UPNPDEVICE_MANUFACTURERNAME       (DISPID_UPNPDEVICE   + 10)
  117. #define DISPID_UPNPDEVICE_MANUFACTURERURL        (DISPID_UPNPDEVICE   + 11)
  118. #define DISPID_UPNPDEVICE_MODELNAME              (DISPID_UPNPDEVICE   + 12)
  119. #define DISPID_UPNPDEVICE_MODELNUMBER            (DISPID_UPNPDEVICE   + 13)
  120. #define DISPID_UPNPDEVICE_DESCRIPTION            (DISPID_UPNPDEVICE   + 14)
  121. #define DISPID_UPNPDEVICE_MODELURL               (DISPID_UPNPDEVICE   + 15)
  122. #define DISPID_UPNPDEVICE_UPC                    (DISPID_UPNPDEVICE   + 16)
  123. #define DISPID_UPNPDEVICE_SERIALNUMBER           (DISPID_UPNPDEVICE   + 17)
  124. #define DISPID_UPNPDEVICE_LOADSMALLICON          (DISPID_UPNPDEVICE   + 18)
  125. #define DISPID_UPNPDEVICE_LOADICON               (DISPID_UPNPDEVICE   + 19)
  126. #define DISPID_UPNPDEVICE_SERVICES               (DISPID_UPNPDEVICE   + 20)
  128. #define DISPID_UPNPDESCRIPTIONDOC_LOAD           (DISPID_UPNPDESCRIPTIONDOC + 1)
  129. #define DISPID_UPNPDESCRIPTIONDOC_LOADASYNC      (DISPID_UPNPDESCRIPTIONDOC + 2)
  130. #define DISPID_UPNPDESCRIPTIONDOC_LOADERROR      (DISPID_UPNPDESCRIPTIONDOC + 3)
  131. #define DISPID_UPNPDESCRIPTIONDOC_ABORT          (DISPID_UPNPDESCRIPTIONDOC + 4)
  132. #define DISPID_UPNPDESCRIPTIONDOC_ROOTDEVICE     (DISPID_UPNPDESCRIPTIONDOC + 5)
  133. #define DISPID_UPNPDESCRIPTIONDOC_DEVICEBYUDN    (DISPID_UPNPDESCRIPTIONDOC + 6)
  135. [
  136.     object,
  137.     uuid(ADDA3D55-6F72-4319-BFF9-18600A539B10),
  138.     dual,
  139.     helpstring("IUPnPDeviceFinder Interface"),
  140.     oleautomation,
  141.     pointer_default(unique),
  142.     nonextensible
  143. ]
  144. interface IUPnPDeviceFinder : IDispatch
  145. {
  146.     [id(DISPID_UPNPFINDDEVICES_FINDBYTYPE),
  147.      helpstring("method FindByType")]
  148.     HRESULT FindByType([in] BSTR bstrTypeURI,
  149.                        [in] DWORD dwFlags,
  150.                        [out, retval] IUPnPDevices ** pDevices);
  152.     [id(DISPID_UPNPFINDDEVICES_CREATEASYNCFIND),
  153.      helpstring("method CreateAsyncFind")]
  154.     HRESULT CreateAsyncFind([in] BSTR bstrTypeURI,
  155.                             [in] DWORD dwFlags,
  156.                             [in] IUnknown * punkDeviceFinderCallback,
  157.                             [out, retval] LONG * plFindData);
  159.     [id(DISPID_UPNPFINDDEVICES_STARTASYNCFIND),
  160.      helpstring("method StartAsyncFind")]
  161.     HRESULT StartAsyncFind([in] LONG lFindData);
  163.     [id(DISPID_UPNPFINDDEVICES_CANCELASYNCFIND),
  164.      helpstring("method CancelAsyncFind")]
  165.     HRESULT CancelAsyncFind([in] LONG lFindData);
  167.     [id(DISPID_UPNPFINDDEVICES_FINDBYUDN),
  168.      helpstring("method FindByUDN")]
  169.     HRESULT FindByUDN([in] BSTR bstrUDN,
  170.                       [out, retval] IUPnPDevice ** pDevice);
  171. };
  174. [
  175.     object,
  176.     uuid(415A984A-88B3-49F3-92AF-0508BEDF0D6C),
  177.     pointer_default(unique)
  178. ]
  179. interface IUPnPDeviceFinderCallback : IUnknown
  180. {
  181.     HRESULT DeviceAdded([in] LONG lFindData,
  182.                         [in] IUPnPDevice * pDevice);
  184.     HRESULT DeviceRemoved([in] LONG lFindData,
  185.                           [in] BSTR bstrUDN);
  187.     HRESULT SearchComplete([in] LONG lFindData);
  188. };
  191. [
  192.     object,
  193.     uuid(3F8C8E9E-9A7A-4DC8-BC41-FF31FA374956),
  194.     dual,
  195.     helpstring("IUPnPServices Interface"),
  196.     pointer_default(unique),
  197.     nonextensible
  198. ]
  199. interface IUPnPServices : IDispatch
  200. {
  201.     [propget, id(DISPID_UPNPSERVICES_COUNT), helpstring("property Count")]
  202.     HRESULT Count([out, retval] long *plCount);
  204.     [propget, id(DISPID_NEWENUM), restricted, hidden, helpstring("property _NewEnum")]
  205.     HRESULT _NewEnum([out, retval] LPUNKNOWN *ppunk);
  207.     [propget, id(DISPID_VALUE), helpstring("property Item")]
  208.     HRESULT Item([in] BSTR bstrServiceId,
  209.                  [out, retval] IUPnPService ** ppService);
  210. };
  213. [
  214.     object,
  215.     uuid(A295019C-DC65-47DD-90DC-7FE918A1AB44),
  216.     dual,
  217.     helpstring("IUPnPService Interface"),
  218.     oleautomation,
  219.     pointer_default(unique),
  220.     nonextensible
  222. ]
  223. interface IUPnPService : IDispatch
  224. {
  225.     [id(DISPID_UPNPSERVICE_QUERYSTATEVARIABLE),
  226.      helpstring("method QueryStateVariable")]
  227.     HRESULT QueryStateVariable([in] BSTR bstrVariableName,
  228.                                [out, retval] VARIANT *pValue);
  230.     [id(DISPID_UPNPSERVICE_INVOKEACTION),
  231.      helpstring("method InvokeAction")]
  232.     HRESULT InvokeAction([in] BSTR bstrActionName,
  233.                          [in] VARIANT vInActionArgs,
  234.                          [in, out] VARIANT * pvOutActionArgs,
  235.                          [out, retval] VARIANT *pvRetVal);
  237.     [propget, id(DISPID_UPNPSERVICE_SERVICETYPEIDENTIFIER),
  238.      helpstring("property ServiceTypeIdentifier")]
  239.     HRESULT ServiceTypeIdentifier([out, retval] BSTR *pVal);
  241.     [id(DISPID_UPNPSERVICE_ADDSTATECHANGECALLBACK),
  242.      helpstring("method AddStateChangeCallback")]
  243.     HRESULT AddCallback([in] IUnknown  * pUnkCallback);
  245.     [propget, id(DISPID_UPNPSERVICE_SERVICEID),
  246.      helpstring("property Id")]
  247.     HRESULT Id([out, retval] BSTR *pbstrId);
  249.     [propget, id(DISPID_UPNPSERVICE_LASTTRANSPORTSTATUS),
  250.      helpstring("property LastTransportStatus")]
  251.     HRESULT LastTransportStatus([out, retval] long * plValue);
  252. };
  254. [
  255.     object,
  256.     uuid(31fadca9-ab73-464b-b67d-5c1d0f83c8b8),
  257.     pointer_default(unique)
  258. ]
  259. interface IUPnPServiceCallback : IUnknown
  260. {
  261.     HRESULT
  262.     StateVariableChanged([in]   IUPnPService    * pus,
  263.                          [in]   LPCWSTR         pcwszStateVarName,
  264.                          [in]   VARIANT         vaValue);
  265.     HRESULT
  266.     ServiceInstanceDied([in]    IUPnPService    * pus);
  268. };
  271. [
  272.     object,
  273.     uuid(FDBC0C73-BDA3-4C66-AC4F-F2D96FDAD68C),
  274.     dual,
  275.     helpstring("IUPnPDevices Interface"),
  276.     oleautomation,
  277.     pointer_default(unique),
  278.     nonextensible
  279. ]
  280. interface IUPnPDevices : IDispatch
  281. {
  282.     [propget, id(DISPID_UPNPDEVICES_COUNT), helpstring("property Count")]
  283.     HRESULT Count([out, retval] long * plCount);
  285.     [propget, id(DISPID_NEWENUM), restricted, hidden, helpstring("property _NewEnum")]
  286.     HRESULT _NewEnum([out, retval] LPUNKNOWN * ppunk);
  288.     [propget, id(DISPID_VALUE), helpstring("property Item")]
  289.     HRESULT Item([in] BSTR bstrUDN,
  290.                  [out, retval] IUPnPDevice ** ppDevice);
  291. };
  294. [
  295.     object,
  296.     uuid(3D44D0D1-98C9-4889-ACD1-F9D674BF2221),
  297.     dual,
  298.     helpstring("IUPnPDevice Interface"),
  299.     oleautomation,
  300.     pointer_default(unique),
  301.     nonextensible
  302. ]
  303. interface IUPnPDevice : IDispatch
  304. {
  305.     [propget, id(DISPID_UPNPDEVICE_ISROOTDEVICE),
  306.      helpstring("denotes whether the device is the highest-level device in the device tree")]
  307.     HRESULT IsRootDevice([out, retval] VARIANT_BOOL * pvarb);
  309.     [propget, id(DISPID_UPNPDEVICE_ROOT),
  310.      helpstring("returns the top device in the device tree")]
  311.     HRESULT RootDevice([out, retval] IUPnPDevice ** ppudRootDevice);
  313.     [propget, id(DISPID_UPNPDEVICE_PARENT),
  314.      helpstring("returns the parent of the current device")]
  315.     HRESULT ParentDevice([out, retval] IUPnPDevice ** ppudDeviceParent);
  317.     [propget, id(DISPID_UPNPDEVICE_HASCHILDREN),
  318.      helpstring("denotes whether the current device contains child devices")]
  319.     HRESULT HasChildren([out, retval] VARIANT_BOOL * pvarb);
  321.     [propget, id(DISPID_UPNPDEVICE_CHILDREN),
  322.      helpstring("returns a collection of the children of the current device")]
  323.     HRESULT Children([out, retval] IUPnPDevices ** ppudChildren);
  325.     [propget, id(DISPID_UPNPDEVICE_UDN),
  326.      helpstring("returns the UDN of the device")]
  327.     HRESULT UniqueDeviceName([out, retval] BSTR * pbstr);
  329.     [propget, id(DISPID_UPNPDEVICE_FRIENDLYNAME),
  330.      helpstring("returns the (optional) display name of the device")]
  331.     HRESULT FriendlyName([out, retval] BSTR * pbstr);
  333.     [propget, id(DISPID_UPNPDEVICE_DEVICETYPE),
  334.      helpstring("returns the device type URI")]
  335.     HRESULT Type([out, retval] BSTR * pbstr);
  337.     [propget, id(DISPID_UPNPDEVICE_PRESENTATIONURL),
  338.      helpstring("obtains a presentation URL to a web page that can control the device")]
  339.     HRESULT PresentationURL([out, retval] BSTR * pbstr);
  341.     [propget, id(DISPID_UPNPDEVICE_MANUFACTURERNAME),
  342.      helpstring("displayable manufacturer name")]
  343.     HRESULT ManufacturerName([out, retval] BSTR * pbstr);
  345.     [propget, id(DISPID_UPNPDEVICE_MANUFACTURERURL),
  346.      helpstring("URL to the manufacturer's website")]
  347.     HRESULT ManufacturerURL([out, retval] BSTR * pbstr);
  349.     [propget, id(DISPID_UPNPDEVICE_MODELNAME),
  350.      helpstring("a displayable string containing the model name")]
  351.     HRESULT ModelName([out, retval] BSTR * pbstr);
  353.     [propget, id(DISPID_UPNPDEVICE_MODELNUMBER),
  354.      helpstring("a displayable string containing the model number")]
  355.     HRESULT ModelNumber([out, retval] BSTR * pbstr);
  357.     [propget, id(DISPID_UPNPDEVICE_DESCRIPTION),
  358.      helpstring("displayable summary of the device's function")]
  359.     HRESULT Description([out, retval] BSTR * pbstr);
  361.     [propget, id(DISPID_UPNPDEVICE_MODELURL),
  362.      helpstring("URL to a webpage containing model-specific information")]
  363.     HRESULT ModelURL([out, retval] BSTR * pbstr);
  365.     [propget, id(DISPID_UPNPDEVICE_UPC),
  366.      helpstring("displayable product code")]
  367.     HRESULT UPC([out, retval] BSTR * pbstr);
  369.     [propget, id(DISPID_UPNPDEVICE_SERIALNUMBER),
  370.      helpstring("displayable serial number")]
  371.     HRESULT SerialNumber([out, retval] BSTR * pbstr);
  373.     [id(DISPID_UPNPDEVICE_LOADICON),
  374.      helpstring("retrieves an url from which an icon of the specified format can be loaded")]
  375.     HRESULT IconURL([in] BSTR bstrEncodingFormat,
  376.                     [in] LONG lSizeX,
  377.                     [in] LONG lSizeY,
  378.                     [in] LONG lBitDepth,
  379.                     [out, retval] BSTR * pbstrIconURL);
  381.     [propget, id(DISPID_UPNPDEVICE_SERVICES),
  382.      helpstring("returns the collection of services exposed by the device")]
  383.     HRESULT Services([out, retval] IUPnPServices ** ppusServices);
  384. };
  386. [
  387.     object,
  388.     uuid(E7772804-3287-418e-9072-CF2B47238981),
  389.     pointer_default(unique)
  390. ]
  391. interface IUPnPDeviceDocumentAccess : IUnknown
  392. {
  393.     HRESULT GetDocumentURL([out, retval] BSTR * pbstrDocument);
  394. }
  396. [
  397.     object,
  398.     uuid(11d1c1b2-7daa-4c9e-9595-7f82ed206d1e),
  399.     dual,
  400.     helpstring("IUPnPDescriptionDocument Interface"),
  401.     oleautomation,
  402.     pointer_default(unique),
  403.     nonextensible
  404. ]
  405. interface IUPnPDescriptionDocument : IDispatch
  406. {
  407.     [propget, id(DISPID_READYSTATE),
  408.      helpstring("the current status of the document's loading process")]
  409.     HRESULT ReadyState([out, retval] LONG * plReadyState);
  411.     [id(DISPID_UPNPDESCRIPTIONDOC_LOAD),
  412.      helpstring("loads a document synchronously from an URL")]
  413.     HRESULT Load([in] BSTR bstrUrl);
  415.     [id(DISPID_UPNPDESCRIPTIONDOC_LOADASYNC),
  416.      helpstring("starts an asynchronous download, returning immediately")]
  417.     HRESULT LoadAsync([in] BSTR bstrUrl, [in] IUnknown * punkCallback);
  419.     [propget, id(DISPID_UPNPDESCRIPTIONDOC_LOADERROR),
  420.      helpstring("the success or failure code of the completed load operation")]
  421.     HRESULT LoadResult([out, retval] long * phrError);
  423.     [id(DISPID_UPNPDESCRIPTIONDOC_ABORT),
  424.      helpstring("stops an asynchronous loading operation")]
  425.     HRESULT Abort();
  427.     [id(DISPID_UPNPDESCRIPTIONDOC_ROOTDEVICE),
  428.      helpstring("returns the root device of the loaded document's device tree")]
  429.     HRESULT RootDevice([out, retval] IUPnPDevice ** ppudRootDevice);
  431.     [id(DISPID_UPNPDESCRIPTIONDOC_DEVICEBYUDN),
  432.      helpstring("returns a device by its unique device name (UDN)")]
  433.     HRESULT DeviceByUDN([in] BSTR bstrUDN,
  434.                         [out, retval] IUPnPDevice ** ppudDevice);
  435. };
  437. [
  438.     object,
  439.     uuid(77394c69-5486-40d6-9bc3-4991983e02da),
  440.     pointer_default(unique)
  441. ]
  442. interface IUPnPDescriptionDocumentCallback : IUnknown
  443. {
  444.     HRESULT LoadComplete([in] HRESULT hrLoadResult);
  445. };
  447. [
  448.     uuid(DB3442A7-A2E9-4A59-9CB5-F5C1A5D901E5),
  449.     version(1.0),
  450.     helpstring("UPnP 1.0 Type Library")
  451. ]
  452. library UPNPLib
  453. {
  454.     importlib("stdole2.tlb");
  456.     [
  457.         uuid(E2085F28-FEB7-404A-B8E7-E659BDEAAA02),
  458.         helpstring("UPnPDeviceFinder Class")
  459.     ]
  460.     coclass UPnPDeviceFinder
  461.     {
  462.         [default] interface IUPnPDeviceFinder;
  463.     };
  464.     [
  465.         uuid(B9E84FFD-AD3C-40A4-B835-0882EBCBAAA8),
  466.         helpstring("UPnPDevices Class")
  467.     ]
  468.     coclass UPnPDevices
  469.     {
  470.         [default] interface IUPnPDevices;
  471.     };
  472.     [
  473.         uuid(A32552C5-BA61-457A-B59A-A2561E125E33),
  474.         helpstring("UPnPDevice Class")
  475.     ]
  476.     coclass UPnPDevice
  477.     {
  478.         [default] interface IUPnPDevice;
  480.     };
  481.     [
  482.         uuid(C0BC4B4A-A406-4EFC-932F-B8546B8100CC),
  483.         helpstring("UPnPServices Class")
  484.     ]
  485.     coclass UPnPServices
  486.     {
  487.         [default] interface IUPnPServices;
  488.     };
  489.     [
  490.         uuid(C624BA95-FBCB-4409-8C03-8CCEEC533EF1),
  491.         helpstring("UPnPService Class")
  492.     ]
  493.     coclass UPnPService
  494.     {
  495.         [default] interface IUPnPService;
  496.     };
  498.     [
  499.         uuid(1d8a9b47-3a28-4ce2-8a4b-bd34e45bceeb),
  500.         helpstring("UPnPDescriptionDocument Class")
  501.     ]
  502.     coclass UPnPDescriptionDocument
  503.     {
  504.         [default] interface IUPnPDescriptionDocument;
  505.     };
  507.     [
  508.         oleautomation,
  509.         uuid(6BD34909-54E7-4fbf-8562-7B89709A589A),
  510.         pointer_default(unique)
  511.     ]
  512.     interface IUPnPDeviceHostSetup : IUnknown
  513.     {
  514.         HRESULT AskIfNotAlreadyEnabled([out, retval] VARIANT_BOOL * pbEnabled);
  515.     };
  517.     [
  518.         uuid(B4609411-C81C-4cce-8C76-C6B50C9402C6),
  519.         helpstring("UPnPDeviceHostSetup Class")
  520.     ]
  521.     coclass UPnPDeviceHostSetup
  522.     {
  523.         [default] interface IUnknown;
  524.     };
  526.     interface IUPnPDeviceDocumentAccess;
  527. };