include/exdisp.idl

   1 /*
   2  * Defines the COM interfaces and APIs related to the IE Web browser
   3  *
   4  * Copyright (C) 2001 John R. Sheets (for CodeWeavers)
   5  * Copyright (C) 2003 Alexandre Julliard
   6  * Copyright (C) 2004 Jacek Caban
   7  *
   8  * This library is free software; you can redistribute it and/or
   9  * modify it under the terms of the GNU Lesser General Public
  10  * License as published by the Free Software Foundation; either
  11  * version 2.1 of the License, or (at your option) any later version.
  12  *
  13  * This library is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16  * Lesser General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU Lesser General Public
  19  * License along with this library; if not, write to the Free Software
  20  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  21  */
  22
  23 import "ocidl.idl";
  24 import "docobj.idl";
  25
  26 #include <olectl.h>
  27 #include <exdispid.h>
  28
  29 #ifndef __WIDL__
  30 #define threading(model)
  31 #define progid(str)
  32 #define vi_progid(str)
  33 #endif
  34
  35 cpp_quote("#ifdef WINE_NO_UNICODE_MACROS")
  36 cpp_quote("#undef FindText")
  37 cpp_quote("#endif")
  38
  39 /*****************************************************************************
  40  * SHDocVw library
  41  */
  42 [
  43     uuid(EAB22AC0-30C1-11CF-A7EB-0000C05BAE0B),
  44     version(1.1),
  45     helpstring("Microsoft Internet Controls")
  46 ]
  47 library SHDocVw
  48 {
  49
  50 importlib("stdole2.tlb");
  51
  52
  53 /*****************************************************************************
  54  * IWebBrowser interface
  55  */
  56 [
  57     object,
  58     oleautomation,
  59     uuid(eab22ac1-30c1-11cf-a7eb-0000c05bae0b),
  60     hidden,
  61     dual
  62 ]
  63 interface IWebBrowser : IDispatch
  64 {
  65     typedef enum BrowserNavConstants
  66     {
  67         navOpenInNewWindow   = 0x1,
  68         navNoHistory         = 0x2,
  69         navNoReadFromCache   = 0x4,
  70         navNoWriteToCache    = 0x8,
  71         navAllowAutosearch   = 0x10,
  72         navBrowserBar        = 0x20,
  73         navHyperlink         = 0x40,
  74         navEnforceRestricted = 0x80
  75     } BrowserNavConstants;
  76
  77     typedef enum RefreshConstants
  78     {
  79         REFRESH_NORMAL     = 0,
  80         REFRESH_IFEXPIRED  = 1,
  81         REFRESH_COMPLETELY = 3
  82     } RefreshConstants;
  83
  84     [id(100)] HRESULT GoBack();
  85     [id(101)] HRESULT GoForward();
  86     [id(102)] HRESULT GoHome();
  87     [id(103)] HRESULT GoSearch();
  88
  89     [id(104)]
  90     HRESULT Navigate(
  91         [in] BSTR URL,
  92         [in, optional] VARIANT *Flags,
  93         [in, optional] VARIANT *TargetFrameName,
  94         [in, optional] VARIANT *PostData,
  95         [in, optional] VARIANT *Headers);
  96
  97     [id(DISPID_REFRESH)] HRESULT Refresh();
  98     [id(105)] HRESULT Refresh2([in, optional] VARIANT *Level);
  99     [id(106)] HRESULT Stop();
 100     [id(200), propget] HRESULT Application([out, retval] IDispatch** ppDisp);
 101     [id(201), propget] HRESULT Parent([out, retval] IDispatch** ppDisp);
 102     [id(202), propget] HRESULT Container([out, retval] IDispatch** ppDisp);
 103     [id(203), propget] HRESULT Document([out, retval] IDispatch** ppDisp);
 104     [id(204), propget] HRESULT TopLevelContainer([out, retval] VARIANT_BOOL* pBool);
 105     [id(205), propget] HRESULT Type([out, retval] BSTR* Type);
 106     [id(206), propget] HRESULT Left([out, retval] long *pl);
 107     [id(206), propput] HRESULT Left([in] long Left);
 108     [id(207), propget] HRESULT Top([out, retval] long *pl);
 109     [id(207), propput] HRESULT Top([in] long Top);
 110     [id(208), propget] HRESULT Width([out, retval] long *pl);
 111     [id(208), propput] HRESULT Width([in] long Width);
 112     [id(209), propget] HRESULT Height([out, retval] long *pl);
 113     [id(209), propput] HRESULT Height([in] long Height);
 114     [id(210), propget] HRESULT LocationName([out, retval] BSTR *LocationName);
 115     [id(211), propget] HRESULT LocationURL([out, retval] BSTR *LocationURL);
 116     [id(212), propget] HRESULT Busy([out, retval] VARIANT_BOOL *pBool);
 117 }
 118
 119 /*****************************************************************************
 120  * DWebBrowserEvents dispinterface
 121  */
 122 [
 123     uuid(eab22ac2-30c1-11CF-a7eb-0000C05bae0b),
 124     hidden
 125 ]
 126 dispinterface DWebBrowserEvents
 127 {
 128     properties:
 129     methods:
 130     [id(DISPID_BEFORENAVIGATE)]
 131     void BeforeNavigate(
 132         [in] BSTR URL,
 133         long Flags,
 134         BSTR TargetFrameName,
 135         VARIANT *PostData,
 136         BSTR Headers,
 137         [in, out] VARIANT_BOOL *Cancel);
 138
 139     [id(DISPID_NAVIGATECOMPLETE)]
 140     void NavigateComplete([in] BSTR URL);
 141
 142     [id(DISPID_STATUSTEXTCHANGE)]
 143     void StatusTextChange([in] BSTR Text);
 144
 145     [id(DISPID_PROGRESSCHANGE)]
 146     void ProgressChange([in] long Progress, [in] long ProgressMax);
 147
 148     [id(DISPID_DOWNLOADCOMPLETE)]
 149     void DownloadComplete();
 150
 151     [id(DISPID_COMMANDSTATECHANGE)]
 152     void CommandStateChange([in] long Command, [in]VARIANT_BOOL Enable);
 153
 154     [id(DISPID_DOWNLOADBEGIN)]
 155     void DownloadBegin();
 156
 157     [id(DISPID_NEWWINDOW)]
 158     void NewWindow(
 159         [in] BSTR URL,
 160         [in] long Flags,
 161         [in] BSTR TargetFrameName,
 162         [in] VARIANT *PostData,
 163         [in] BSTR Headers,
 164         [in,out] VARIANT_BOOL *Processed);
 165
 166     [id(DISPID_TITLECHANGE)]
 167     void TitleChange([in] BSTR Text);
 168
 169     [id(DISPID_FRAMEBEFORENAVIGATE)]
 170     void FrameBeforeNavigate(
 171         [in] BSTR URL,
 172         long Flags,
 173         BSTR TargetFrameName,
 174         VARIANT *PostData,
 175         BSTR Headers,
 176         [in, out]VARIANT_BOOL *Cancel);
 177
 178     [id(DISPID_FRAMENAVIGATECOMPLETE)]
 179     void FrameNavigateComplete([in] BSTR URL);
 180
 181     [id(DISPID_FRAMENEWWINDOW)]
 182     void FrameNewWindow(
 183         [in] BSTR URL,
 184         [in] long Flags,
 185         [in] BSTR TargetFrameName,
 186         [in] VARIANT *PostData,
 187         [in] BSTR Headers,
 188         [in,out] VARIANT_BOOL *Processed);
 189
 190     [id(DISPID_QUIT)]
 191     void Quit([in, out] VARIANT_BOOL *Cancel);
 192
 193     [id(DISPID_WINDOWMOVE)]
 194     void WindowMove();
 195
 196     [id(DISPID_WINDOWRESIZE)]
 197     void WindowResize();
 198
 199     [id(DISPID_WINDOWACTIVATE)]
 200     void WindowActivate();
 201
 202     [id(DISPID_PROPERTYCHANGE)]
 203     void PropertyChange([in] BSTR Property);
 204 }
 205
 206 typedef
 207 [
 208     uuid(34a226e0-df30-11cf-89a9-00a0c9054129)
 209 ]
 210 enum CommandStateChangeConstants {
 211     CSC_UPDATECOMMANDS  = -1,
 212     CSC_NAVIGATEFORWARD = 1,
 213     CSC_NAVIGATEBACK    = 2
 214 } CommandStateChangeConstants;
 215
 216 /*****************************************************************************
 217  * IWebBrowserApp interface
 218  */
 219 [
 220     object,
 221     oleautomation,
 222     uuid(0002df05-0000-0000-c000-000000000046),
 223     hidden,
 224     dual
 225 ]
 226 interface IWebBrowserApp : IWebBrowser
 227 {
 228     [id(300)] HRESULT Quit();
 229     [id(301)] HRESULT ClientToWindow([in,out] int* pcx, [in,out] int* pcy);
 230     [id(302)] HRESULT PutProperty([in] BSTR Property, [in] VARIANT vtValue);
 231     [id(303)] HRESULT GetProperty([in] BSTR Property, [out, retval] VARIANT *pvtValue);
 232     [id(DISPID_VALUE), propget] HRESULT Name([out, retval] BSTR* Name);
 233     [id(DISPID_HWND), propget] HRESULT HWND([out, retval] SHANDLE_PTR *pHWND);
 234     [id(400), propget] HRESULT FullName([out, retval] BSTR* FullName);
 235     [id(401), propget] HRESULT Path([out, retval] BSTR* Path);
 236     [id(402), propget] HRESULT Visible([out, retval] VARIANT_BOOL* pBool);
 237     [id(402), propput] HRESULT Visible([in] VARIANT_BOOL Value);
 238     [id(403), propget] HRESULT StatusBar([out, retval] VARIANT_BOOL* pBool);
 239     [id(403), propput] HRESULT StatusBar([in] VARIANT_BOOL Value);
 240     [id(404), propget] HRESULT StatusText([out, retval] BSTR *StatusText);
 241     [id(404), propput] HRESULT StatusText([in] BSTR StatusText);
 242     [id(405), propget] HRESULT ToolBar([out, retval] int * Value);
 243     [id(405), propput] HRESULT ToolBar([in] int Value);
 244     [id(406), propget] HRESULT MenuBar([out, retval] VARIANT_BOOL *Value);
 245     [id(406), propput] HRESULT MenuBar([in] VARIANT_BOOL Value);
 246     [id(407), propget] HRESULT FullScreen([out, retval] VARIANT_BOOL *pbFullScreen);
 247     [id(407), propput] HRESULT FullScreen([in] VARIANT_BOOL bFullScreen);
 248 }
 249
 250 /*****************************************************************************
 251  * IWebBrowser2 interface
 252  */
 253 [
 254     object,
 255     oleautomation,
 256     uuid(d30c1661-cdaf-11d0-8a3e-00c04fc9e26e),
 257     hidden,
 258     dual
 259 ]
 260 interface IWebBrowser2 : IWebBrowserApp
 261 {
 262     [id(500)] HRESULT Navigate2(
 263         [in] VARIANT *URL,
 264         [in, optional] VARIANT *Flags,
 265         [in, optional] VARIANT *TargetFrameName,
 266         [in, optional] VARIANT *PostData,
 267         [in, optional] VARIANT *Headers);
 268
 269     [id(501)] HRESULT QueryStatusWB(
 270         [in] OLECMDID cmdID,
 271         [out, retval] OLECMDF *pcmdf);
 272
 273     [id(502)] HRESULT ExecWB(
 274         [in] OLECMDID cmdID,
 275         [in] OLECMDEXECOPT cmdexecopt,
 276         [in, optional] VARIANT *pvaIn,
 277         [out, in, optional] VARIANT *pvaOut);
 278
 279     [id(503)] HRESULT ShowBrowserBar(
 280         [in] VARIANT *pvaClsid,
 281         [in, optional] VARIANT *pvarShow,
 282         [in, optional] VARIANT *pvarSize);
 283
 284     [id(DISPID_READYSTATE), propget, bindable]
 285     HRESULT ReadyState([out, retval] READYSTATE *plReadyState);
 286
 287     [id(550), propget] HRESULT Offline([out, retval] VARIANT_BOOL *pbOffline);
 288     [id(550), propput] HRESULT Offline([in] VARIANT_BOOL bOffline);
 289     [id(551), propget] HRESULT Silent([out, retval] VARIANT_BOOL *pbSilent);
 290     [id(551), propput] HRESULT Silent([in] VARIANT_BOOL bSilent);
 291     [id(552), propget] HRESULT RegisterAsBrowser([out, retval] VARIANT_BOOL *pbRegister);
 292     [id(552), propput] HRESULT RegisterAsBrowser([in] VARIANT_BOOL bRegister);
 293     [id(553), propget] HRESULT RegisterAsDropTarget([out, retval] VARIANT_BOOL *pbRegister);
 294     [id(553), propput] HRESULT RegisterAsDropTarget([in] VARIANT_BOOL bRegister);
 295     [id(554), propget] HRESULT TheaterMode([out, retval] VARIANT_BOOL *pbRegister);
 296     [id(554), propput] HRESULT TheaterMode([in] VARIANT_BOOL bRegister);
 297     [id(555), propget] HRESULT AddressBar([out, retval] VARIANT_BOOL *Value);
 298     [id(555), propput] HRESULT AddressBar([in] VARIANT_BOOL Value);
 299     [id(556), propget] HRESULT Resizable([out, retval] VARIANT_BOOL *Value);
 300     [id(556), propput] HRESULT Resizable([in] VARIANT_BOOL Value);
 301 }
 302
 303 typedef
 304 [
 305     uuid(65507be0-91a8-11d3-a845-009027220e6d)
 306 ]
 307 enum SecureLockIconConstants {
 308     secureLockIconUnsecure          = 0,
 309     secureLockIconMixed             = 1,
 310     secureLockIconSecureUnknownBits = 2,
 311     secureLockIconSecure40Bit       = 3,
 312     secureLockIconSecure56Bit       = 4,
 313     secureLockIconSecureFortezza    = 5,
 314     secureLockIconSecure128Bit      = 6
 315 } SecureLockIconConstants;
 316
 317 /*****************************************************************************
 318  * DWebBrowserEvents2 dispinterface
 319  */
 320 [
 321     uuid(34a715a0-6587-11d0-924a-0020afc7ac4d),
 322     hidden
 323 ]
 324 dispinterface DWebBrowserEvents2
 325 {
 326     properties:
 327     methods:
 328     [id(DISPID_STATUSTEXTCHANGE)]
 329     void StatusTextChange([in] BSTR Text);
 330
 331     [id(DISPID_PROGRESSCHANGE)]
 332     void ProgressChange([in] long Progress, [in] long ProgressMax);
 333
 334     [id(DISPID_COMMANDSTATECHANGE)]
 335     void CommandStateChange([in] long Command, [in] VARIANT_BOOL Enable);
 336
 337     [id(DISPID_DOWNLOADBEGIN)]
 338     void DownloadBegin();
 339
 340     [id(DISPID_DOWNLOADCOMPLETE)]
 341     void DownloadComplete();
 342
 343     [id(DISPID_TITLECHANGE)]
 344     void TitleChange([in] BSTR Text);
 345
 346     [id(DISPID_PROPERTYCHANGE)]
 347     void PropertyChange([in] BSTR szProperty);
 348
 349     [id(DISPID_BEFORENAVIGATE2)]
 350     void BeforeNavigate2(
 351         [in] IDispatch *pDisp,
 352         [in] VARIANT *URL,
 353         [in] VARIANT *Flags,
 354         [in] VARIANT *TargetFrameName,
 355         [in] VARIANT *PostData,
 356         [in] VARIANT *Headers,
 357         [in, out] VARIANT_BOOL *Cancel);
 358
 359     [id(DISPID_NEWWINDOW2)]
 360     void NewWindow2([in, out] IDispatch **ppDisp, [in, out] VARIANT_BOOL *Cancel);
 361
 362     [id(DISPID_NAVIGATECOMPLETE2)]
 363     void NavigateComplete2([in] IDispatch *pDisp, [in] VARIANT *URL);
 364
 365     [id(DISPID_DOCUMENTCOMPLETE)]
 366     void DocumentComplete([in] IDispatch *pDisp, [in] VARIANT *URL);
 367
 368     [id(DISPID_ONQUIT)]
 369     void OnQuit();
 370
 371     [id(DISPID_ONVISIBLE)]
 372     void OnVisible([in] VARIANT_BOOL Visible);
 373
 374     [id(DISPID_ONTOOLBAR)]
 375     void OnToolBar([in] VARIANT_BOOL ToolBar);
 376
 377     [id(DISPID_ONMENUBAR)]
 378     void OnMenuBar([in] VARIANT_BOOL MenuBar);
 379
 380     [id(DISPID_ONSTATUSBAR)]
 381     void OnStatusBar([in] VARIANT_BOOL StatusBar);
 382
 383     [id(DISPID_ONFULLSCREEN)]
 384     void OnFullScreen([in] VARIANT_BOOL FullScreen);
 385
 386     [id(DISPID_ONTHEATERMODE)]
 387     void OnTheaterMode([in] VARIANT_BOOL TheaterMode);
 388
 389     [id(DISPID_WINDOWSETRESIZABLE)]
 390     void WindowSetResizable([in] VARIANT_BOOL Resizable);
 391
 392     [id(DISPID_WINDOWSETLEFT)]
 393     void WindowSetLeft([in] long Left);
 394
 395     [id(DISPID_WINDOWSETTOP)]
 396     void WindowSetTop([in] long Top);
 397
 398     [id(DISPID_WINDOWSETWIDTH)]
 399     void WindowSetWidth([in] long Width);
 400
 401     [id(DISPID_WINDOWSETHEIGHT)]
 402     void WindowSetHeight([in] long Height);
 403
 404     [id(DISPID_WINDOWCLOSING)]
 405     void WindowClosing(
 406             [in] VARIANT_BOOL IsChildWindow,
 407             [in, out] VARIANT_BOOL *Cancel);
 408
 409     [id(DISPID_CLIENTTOHOSTWINDOW)]
 410     void ClientToHostWindow(
 411             [in, out] long *CX,
 412             [in, out] long *CY);
 413
 414     [id(DISPID_SETSECURELOCKICON)]
 415     void SetSecureLockIcon([in] long SecureLockIcon);
 416
 417     [id(DISPID_FILEDOWNLOAD)]
 418     void FileDownload(
 419             [in] VARIANT_BOOL ActiveDocument,
 420             [in, out] VARIANT_BOOL *Cancel);
 421
 422     [id(DISPID_NAVIGATEERROR)]
 423     void NavigateError(
 424             [in] IDispatch *pDisp,
 425             [in] VARIANT *URL,
 426             [in] VARIANT *Frame,
 427             [in] VARIANT *StatusCode,
 428             [in, out] VARIANT_BOOL *Cancel);
 429
 430     [id(DISPID_PRINTTEMPLATEINSTANTIATION)]
 431     void PrintTemplateInstantiation([in] IDispatch *pDisp);
 432
 433     [id(DISPID_PRINTTEMPLATETEARDOWN)]
 434     void PrintTemplateTeardown([in] IDispatch *pDisp);
 435
 436     [id(DISPID_UPDATEPAGESTATUS)]
 437     void UpdatePageStatus(
 438             [in] IDispatch *pDisp,
 439             [in] VARIANT *nPage,
 440             [in] VARIANT *fDone);
 441
 442     [id(DISPID_PRIVACYIMPACTEDSTATECHANGE)]
 443     void PrivacyImpactedStateChange([in] VARIANT_BOOL bImpacted);
 444
 445     [id(DISPID_NEWWINDOW3)]
 446     void NewWindow3(
 447             [in, out] IDispatch **ppDisp,
 448             [in, out] VARIANT_BOOL *Cancel,
 449             [in] DWORD dwFlags,
 450             [in] BSTR bstrUrlContext,
 451             [in] BSTR bstrUrl);
 452
 453     [id(DISPID_SETPHISHINGFILTERSTATUS)]
 454     void SetPhishingFilterStatus([in] long PhishingFilterStatus);
 455
 456     [id(DISPID_WINDOWSTATECHANGED)]
 457     void WindowStateChanged(
 458             [in] DWORD dwWindowStateFlags,
 459             [in] DWORD dwValidFlagsMask);
 460
 461     [id(DISPID_NEWPROCESS)]
 462     void NewProcess(
 463             [in] long lCauseFlag,
 464             [in] IDispatch *pWB2,
 465             [in, out] VARIANT_BOOL *Cancel);
 466
 467     [id(DISPID_THIRDPARTYURLBLOCKED)]
 468     void ThirdPartyUrlBlocked(
 469             [in] VARIANT *URL,
 470             [in] DWORD dwCount);
 471
 472     [id(DISPID_REDIRECTXDOMAINBLOCKED)]
 473     void RedirectXDomainBlocked(
 474             [in] IDispatch *pDisp,
 475             [in] VARIANT *StartURL,
 476             [in] VARIANT *RedirectURL,
 477             [in] VARIANT *Frame,
 478             [in] VARIANT *StatusCode);
 479
 480     [id(DISPID_BEFORESCRIPTEXECUTE)]
 481     void BeforeScriptExecute([in] IDispatch *pDispWindow);
 482
 483     [id(DISPID_WEBWORKERSTARTED)]
 484     void WebWorkerStarted(
 485             [in] DWORD dwUniqueID,
 486             [in] BSTR bstrWorkerLabel);
 487
 488     [id(DISPID_WEBWORKERFINISHED)]
 489     void WebWorkerFinsihed([in] DWORD dwUniqueID);
 490 }
 491
 492 [
 493     helpstring("Microsoft Web Browser Version 1"),
 494     threading(apartment),
 495     progid("Shell.Explorer.1"),
 496     vi_progid("Shell.Explorer"),
 497     uuid(eab22ac3-30c1-11cf-a7eb-0000c05bae0b),
 498     control
 499 ]
 500 coclass WebBrowser_V1
 501 {
 502     interface IWebBrowser2;
 503     [default] interface IWebBrowser;
 504     [source] dispinterface DWebBrowserEvents2;
 505     [default, source] dispinterface DWebBrowserEvents;
 506 }
 507
 508 [
 509     helpstring("Microsoft Web Browser"),
 510     threading(apartment),
 511     progid("Shell.Explorer.2"),
 512     vi_progid("Shell.Explorer"),
 513     uuid(8856f961-340a-11d0-a96b-00c04fd705a2),
 514     control
 515 ]
 516 coclass WebBrowser
 517 {
 518     [default] interface IWebBrowser2;
 519     interface IWebBrowser;
 520     [default, source] dispinterface DWebBrowserEvents2;
 521     [source] dispinterface DWebBrowserEvents;
 522 }
 523
 524 [
 525     helpstring("Internet Explorer(Ver 1.0)"),
 526     progid("InternetExplorer.Application.1"),
 527     vi_progid("InternetExplorer.Application"),
 528     uuid(0002df01-0000-0000-c000-000000000046)
 529 ]
 530 coclass InternetExplorer
 531 {
 532     [default] interface IWebBrowser2;
 533               interface IWebBrowserApp;
 534     [default, source] dispinterface DWebBrowserEvents2;
 535     [source]          dispinterface DWebBrowserEvents;
 536 }
 537
 538 [
 539     uuid(C08AFD90-F2A1-11D1-8455-00A0C91F3880),
 540     hidden
 541 ]
 542 coclass ShellBrowserWindow
 543 {
 544     [default] interface IWebBrowser2;
 545     interface IWebBrowserApp;
 546     [default, source] dispinterface DWebBrowserEvents2;
 547     [source] dispinterface DWebBrowserEvents;
 548 }
 549
 550 typedef
 551 [
 552     uuid(f41e6981-28e5-11d0-82b4-00a0c90c29c5)
 553 ]
 554 enum ShellWindowTypeConstants {
 555     SWC_EXPLORER = 0,
 556     SWC_BROWSER  = 1,
 557     SWC_3RDPARTY = 2,
 558     SWC_CALLBACK = 4,
 559     SWC_DESKTOP  = 8
 560 } ShellWindowTypeConstants;
 561
 562 typedef
 563 [
 564     uuid(7716a370-38Ca-11d0-a48B-00a0c90a8f39)
 565 ]
 566 enum ShellWindowFindWindowOptions {
 567     SWFO_NEEDDISPATCH   = 1,
 568     SWFO_INCLUDEPENDING = 2,
 569     SWFO_COOKIEPASSED   = 4
 570 } ShellWindowFindWindowOptions;
 571
 572 [
 573     uuid(FE4106E0-399A-11D0-A48C-00A0C90A8F39)
 574 ]
 575 dispinterface DShellWindowsEvents {
 576     properties:
 577     methods:
 578     [id(DISPID_WINDOWREGISTERED)]
 579     void WindowRegistered([in] long lCookie);
 580
 581     [id(DISPID_WINDOWREVOKED)]
 582     void WindowRevoked([in] long lCookie);
 583 }
 584
 585 [
 586     object,
 587     oleautomation,
 588     uuid(85cb6900-4d95-11cf-960c-0080c7f4ee85),
 589     dual
 590 ]
 591 interface IShellWindows : IDispatch
 592 {
 593     [propget] HRESULT Count([out, retval] long *Count);
 594
 595     [id(DISPID_VALUE)]
 596     HRESULT Item(
 597             [in, optional] VARIANT index,
 598             [out, retval] IDispatch **Folder);
 599
 600     [id(DISPID_NEWENUM)]
 601     HRESULT _NewEnum([out, retval] IUnknown **ppunk);
 602
 603     [hidden] HRESULT Register(
 604             [in] IDispatch *pid,
 605             [in] long hWnd,
 606             [in] int swClass,
 607             [out] long *plCookie);
 608
 609     [hidden] HRESULT RegisterPending(
 610             [in] long lThreadId,
 611             [in] VARIANT *pvarloc,
 612             [in] VARIANT *pvarlocRoot,
 613             [in] int swClass,
 614             [out] long *plCookie);
 615
 616     [hidden] HRESULT Revoke([in] long lCookie);
 617     [hidden] HRESULT OnNavigate([in] long lCookie, [in] VARIANT *pvarLoc);
 618     [hidden] HRESULT OnActivated([in] long lCookie, [in] VARIANT_BOOL fActive);
 619     [hidden] HRESULT FindWindowSW(
 620             [in] VARIANT *pvarLoc,
 621             [in] VARIANT *pvarLocRoot,
 622             [in] int swClass,
 623             [out] long *phwnd,
 624             [in] int swfwOptions,
 625             [out, retval] IDispatch **ppdispOut);
 626
 627     [hidden] HRESULT OnCreated([in] long lCookie, [in] IUnknown *punk);
 628     [hidden] HRESULT ProcessAttachDetach([in] VARIANT_BOOL fAttach);
 629 }
 630
 631 [
 632     threading(apartment),
 633     uuid(9ba05972-f6a8-11cf-a442-00a0c90a8f39)
 634 ]
 635 coclass ShellWindows
 636 {
 637     [default] interface IShellWindows;
 638     [default, source] dispinterface DShellWindowsEvents;
 639 }
 640
 641 [
 642     odl,
 643     uuid(729fe2f8-1ea8-11d1-8f85-00C04fc2fbe1),
 644     dual,
 645     oleautomation
 646 ]
 647 interface IShellUIHelper : IDispatch {
 648     [id(1), hidden] HRESULT ResetFirstBootMode();
 649     [id(2), hidden] HRESULT ResetSafeMode();
 650     [id(3), hidden] HRESULT RefreshOfflineDesktop();
 651
 652     [id(4)] HRESULT AddFavorite(
 653             [in] BSTR URL,
 654             [in, optional] VARIANT* Title);
 655
 656     [id(5)] HRESULT AddChannel([in] BSTR URL);
 657
 658     [id(6)] HRESULT AddDesktopComponent(
 659             [in] BSTR URL,
 660             [in] BSTR Type,
 661             [in, optional] VARIANT *Left,
 662             [in, optional] VARIANT *Top,
 663             [in, optional] VARIANT *Width,
 664             [in, optional] VARIANT *Height);
 665
 666     [id(7)] HRESULT IsSubscribed(
 667             [in] BSTR URL,
 668             [out, retval] VARIANT_BOOL *pBool);
 669
 670     [id(8)] HRESULT NavigateAndFind(
 671             [in] BSTR URL,
 672             [in] BSTR strQuery,
 673             [in] VARIANT *varTargetFrame);
 674
 675     [id(9)] HRESULT ImportExportFavorites(
 676             [in] VARIANT_BOOL fImport,
 677             [in] BSTR strImpExpPath);
 678
 679     [id(10)] HRESULT AutoCompleteSaveForm([in, optional] VARIANT *Form);
 680
 681     [id(11)] HRESULT AutoScan(
 682             [in] BSTR strSearch,
 683             [in] BSTR strFailureUrl,
 684             [in, optional] VARIANT *pvarTargetFrame);
 685
 686     [id(12), hidden] HRESULT AutoCompleteAttach([in, optional] VARIANT *Reserved);
 687
 688     [id(13)] HRESULT ShowBrowserUI(
 689             [in] BSTR bstrName,
 690             [in] VARIANT *pvarIn,
 691             [out, retval] VARIANT *pvarOut);
 692 }
 693
 694 [
 695     uuid(a7fe6eda-1932-4281-b881-87b31b8bc52c),
 696     oleautomation,
 697     dual
 698 ]
 699 interface IShellUIHelper2 : IShellUIHelper {
 700     [id(DISPID_ADDSEARCHPROVIDER)]
 701     HRESULT AddSearchProvider([in] BSTR URL);
 702
 703     [id(DISPID_RUNONCESHOWN)]
 704     HRESULT RunOnceShown();
 705
 706     [id(DISPID_SKIPRUNONCE)]
 707     HRESULT SkipRunOnce();
 708
 709     [id(DISPID_CUSTOMIZESETTINGS)] HRESULT CustomizeSettings(
 710         [in] VARIANT_BOOL fSQM,
 711         [in] VARIANT_BOOL fPhishing,
 712         [in] BSTR bstrLocale);
 713
 714     [id(DISPID_SQMENABLED)]
 715     HRESULT SqmEnabled([out, retval] VARIANT_BOOL *pfEnabled);
 716
 717     [id(DISPID_PHISHINGENABLED)]
 718     HRESULT PhishingEnabled([out, retval] VARIANT_BOOL *pfEnabled);
 719
 720     [id(DISPID_BRANDIMAGEURI)]
 721     HRESULT BrandImageUri([out, retval] BSTR *pbstrUri);
 722
 723     [id(DISPID_SKIPTABSWELCOME)]
 724     HRESULT SkipTabsWelcome();
 725
 726     [id(DISPID_DIAGNOSECONNECTION)]
 727     HRESULT DiagnoseConnection();
 728
 729     [id(DISPID_CUSTOMIZECLEARTYPE)]
 730     HRESULT CustomizeClearType([in] VARIANT_BOOL fSet);
 731
 732     [id(DISPID_ISSEARCHPROVIDERINSTALLED)]
 733     HRESULT IsSearchProviderInstalled(
 734         [in] BSTR URL,
 735         [out, retval] DWORD *pdwResult);
 736
 737     [id(DISPID_ISSEARCHMIGRATED)]
 738     HRESULT IsSearchMigrated([out, retval] VARIANT_BOOL *pfMigrated);
 739
 740     [id(DISPID_DEFAULTSEARCHPROVIDER)]
 741     HRESULT DefaultSearchProvider([out, retval] BSTR *pbstrName);
 742
 743     [id(DISPID_RUNONCEREQUIREDSETTINGSCOMPLETE)]
 744     HRESULT RunOnceRequiredSettingsComplete([in] VARIANT_BOOL fComplete);
 745
 746     [id(DISPID_RUNONCEHASSHOWN)]
 747     HRESULT RunOnceHasShown([out, retval] VARIANT_BOOL *pfShown);
 748
 749     [id(DISPID_SEARCHGUIDEURL)]
 750     HRESULT SearchGuideUrl([out, retval] BSTR *pbstrUrl);
 751 }
 752
 753 [
 754     helpstring("Microsoft Shell UI Helper"),
 755     threading(apartment),
 756     progid("Shell.UIHelper.1"),
 757     vi_progid("Shell.UIHelper"),
 758     uuid(64ab4bb7-111e-11d1-8f79-00c04fc2fbe1)
 759 ]
 760 coclass ShellUIHelper {
 761     [default] interface IShellUIHelper2;
 762 }
 763
 764 [
 765     uuid(55136806-b2de-11d1-b9f2-00a0c98bc547)
 766 ]
 767 dispinterface DShellNameSpaceEvents {
 768     properties:
 769     methods:
 770     [id(1)] void FavoritesSelectionChange(
 771             [in] long cItems,
 772             [in] long hItem,
 773             [in] BSTR strName,
 774             [in] BSTR strUrl,
 775             [in] long cVisits,
 776             [in] BSTR strDate,
 777             [in] long fAvailableOffline);
 778
 779     [id(2)] void SelectionChange();
 780     [id(3)] void DoubleClick();
 781     [id(4)] void Initialized();
 782 }
 783
 784 [
 785     odl,
 786     uuid(55136804-b2de-11d1-b9f2-00a0c98bc547),
 787     hidden,
 788     dual,
 789     oleautomation
 790 ]
 791 interface IShellFavoritesNameSpace : IDispatch {
 792     [id(1)] HRESULT MoveSelectionUp();
 793     [id(2)] HRESULT MoveSelectionDown();
 794     [id(3)] HRESULT ResetSort();
 795     [id(4)] HRESULT NewFolder();
 796     [id(5)] HRESULT Synchronize();
 797     [id(6)] HRESULT Import();
 798     [id(7)] HRESULT Export();
 799     [id(8)] HRESULT InvokeContextMenuCommand([in] BSTR strCommand);
 800     [id(9)] HRESULT MoveSelectionTo();
 801     [id(10), propget] HRESULT SubscriptionsEnabled([out, retval] VARIANT_BOOL *pBool);
 802     [id(11)] HRESULT CreateSubscriptionForSelection([out, retval] VARIANT_BOOL *pBool);
 803     [id(12)] HRESULT DeleteSubscriptionForSelection([out, retval] VARIANT_BOOL *pBool);
 804     [id(13)] HRESULT SetRoot([in] BSTR bstrFullPath);
 805 }
 806
 807 [
 808     odl,
 809     uuid(e572d3c9-37be-4ae2-825d-d521763e3108),
 810     hidden,
 811     dual,
 812     oleautomation
 813 ]
 814 interface IShellNameSpace : IShellFavoritesNameSpace {
 815     [id(14), propget] HRESULT EnumOptions([out, retval] long* pgrfEnumFlags);
 816     [id(14), propput] HRESULT EnumOptions([in] long pgrfEnumFlags);
 817
 818     [id(15), propget] HRESULT SelectedItem([out, retval] IDispatch **pItem);
 819     [id(15), propput] HRESULT SelectedItem([in] IDispatch *pItem);
 820
 821     [id(16), propget] HRESULT Root([out, retval] VARIANT *pvar);
 822     [id(16), propput] HRESULT Root([in] VARIANT pvar);
 823
 824     [id(17), propget] HRESULT Depth([out, retval] int *piDepth);
 825     [id(17), propput] HRESULT Depth([in] int piDepth);
 826
 827     [id(18), propget] HRESULT Mode([out, retval] unsigned int *puMode);
 828     [id(18), propput] HRESULT Mode([in] unsigned int puMode);
 829
 830     [id(19), propget] HRESULT Flags([out, retval] unsigned long *pdwFlags);
 831     [id(19), propput] HRESULT Flags([in] unsigned long pdwFlags);
 832
 833     [id(20), propput] HRESULT TVFlags([in] unsigned long dwFlags);
 834     [id(20), propget] HRESULT TVFlags([out, retval] unsigned long *dwFlags);
 835
 836     [id(21), propget] HRESULT Columns([out, retval] BSTR *bstrColumns);
 837     [id(21), propput] HRESULT Columns([in] BSTR bstrColumns);
 838
 839     [id(22), propget] HRESULT CountViewTypes([out, retval] int *piTypes);
 840
 841     [id(23)] HRESULT SetViewType([in] int iType);
 842     [id(24)] HRESULT SelectedItems([out, retval] IDispatch **ppid);
 843     [id(25)] HRESULT Expand([in] VARIANT var,  int iDepth);
 844     [id(26)] HRESULT UnselectAll();
 845 }
 846
 847 [
 848     helpstring("Shell Name Space"),
 849     threading(apartment),
 850     progid("ShellNameSpace.ShellNameSpace.1"),
 851     vi_progid("ShellNameSpace.ShellNameSpace"),
 852     uuid(2f2f1f96-2bc1-4b1c-be28-ea3774f4676a)
 853 ]
 854 coclass ShellShellNameSpace {
 855     [default] interface IShellNameSpace;
 856     [default, source] dispinterface DShellNameSpaceEvents;
 857 }
 858
 859 [
 860     helpstring("Shell Name Space"),
 861     threading(apartment),
 862     progid("ShellNameSpace.ShellNameSpace.1"),
 863     vi_progid("ShellNameSpace.ShellNameSpace"),
 864     uuid(55136805-b2de-11d1-b9f2-00a0c98bc547)
 865 ]
 866 coclass ShellNameSpace {
 867     [default] interface IShellNameSpace;
 868     [default, source] dispinterface DShellNameSpaceEvents;
 869 }
 870
 871 [
 872     odl,
 873     uuid(f3470f24-15fd-11d2-bb2e-00805ff7efca),
 874     hidden,
 875     dual,
 876     oleautomation
 877 ]
 878 interface IScriptErrorList : IDispatch {
 879     [id(10)] HRESULT advanceError();
 880     [id(11)] HRESULT retreatError();
 881     [id(12)] HRESULT canAdvanceError([out, retval] long *pfCanAdvance);
 882     [id(13)] HRESULT canRetreatError([out, retval] long *pfCanRetreat);
 883     [id(14)] HRESULT getErrorLine([out, retval] long *plLine);
 884     [id(15)] HRESULT getErrorChar([out, retval] long *plChar);
 885     [id(16)] HRESULT getErrorCode([out, retval] long *plCode);
 886     [id(17)] HRESULT getErrorMsg([out, retval] BSTR *pstr);
 887     [id(18)] HRESULT getErrorUrl([out, retval] BSTR *pstr);
 888     [id(23)] HRESULT getAlwaysShowLockState([out, retval] long *pfAlwaysShowLocked);
 889     [id(19)] HRESULT getDetailsPaneOpen([out, retval] long *pfDetailsPaneOpen);
 890     [id(20)] HRESULT setDetailsPaneOpen(long fDetailsPaneOpen);
 891     [id(21)] HRESULT getPerErrorDisplay([out, retval] long *pfPerErrorDisplay);
 892     [id(22)] HRESULT setPerErrorDisplay(long fPerErrorDisplay);
 893 }
 894
 895 [
 896     uuid(efd01300-160f-11d2-bb2e-00805ff7efca),
 897     hidden,
 898     noncreatable
 899 ]
 900 coclass CScriptErrorList {
 901     [default] interface IScriptErrorList;
 902 }
 903
 904 [
 905     odl,
 906     uuid(ba9239a4-3dd5-11d2-bf8b-00c04fb93661),
 907     hidden,
 908     dual,
 909     oleautomation
 910 ]
 911 interface ISearch : IDispatch {
 912     [propget] HRESULT Title([out, retval] BSTR *pbstrTitle);
 913     [propget] HRESULT Id([out, retval] BSTR *pbstrId);
 914     [propget] HRESULT URL([out, retval] BSTR *pbstrUrl);
 915 }
 916
 917 [
 918     odl,
 919     uuid(47c922a2-3dd5-11d2-bf8b-00c04fb93661),
 920     hidden,
 921     dual,
 922     oleautomation
 923 ]
 924 interface ISearches : IDispatch {
 925     [propget] HRESULT Count([out, retval] long *plCount);
 926     [propget] HRESULT Default([out, retval] BSTR *pbstrDefault);
 927
 928     HRESULT Item(
 929             [in, optional] VARIANT index,
 930             [out, retval] ISearch **ppid);
 931
 932     [id(DISPID_NEWENUM)]
 933     HRESULT _NewEnum([out, retval] IUnknown **ppunk);
 934 }
 935
 936 [
 937     odl,
 938     uuid(72423e8f-8011-11d2-be79-00a0c9a83da1),
 939     hidden,
 940     dual,
 941     oleautomation
 942 ]
 943 interface ISearchAssistantOC : IDispatch {
 944     [id(1)] HRESULT AddNextMenuItem([in] BSTR bstrText, [in] long idItem);
 945     [id(2)] HRESULT SetDefaultSearchUrl([in] BSTR bstrUrl);
 946     [id(3)] HRESULT NavigateToDefaultSearch();
 947
 948     [id(4)] HRESULT IsRestricted(
 949             [in] BSTR bstrGuid,
 950             [out, retval] VARIANT_BOOL *pVal);
 951
 952     [id(5), propget] HRESULT ShellFeaturesEnabled([out, retval] VARIANT_BOOL *pVal);
 953     [id(6), propget] HRESULT SearchAssistantDefault([out, retval] VARIANT_BOOL *pVal);
 954     [id(7), propget] HRESULT Searches([out, retval] ISearches **ppid);
 955     [id(8), propget] HRESULT InWebFolder([out, retval] VARIANT_BOOL *pVal);
 956
 957     [id(9)] HRESULT PutProperty(
 958             [in] VARIANT_BOOL bPerLocale,
 959             [in] BSTR bstrName,
 960             [in] BSTR bstrValue);
 961
 962     [id(10)] HRESULT GetProperty(
 963             [in] VARIANT_BOOL bPerLocale,
 964             [in] BSTR bstrName,
 965             [out, retval] BSTR *pbstrValue);
 966
 967     [id(11), propput] HRESULT EventHandled([in] VARIANT_BOOL rhs);
 968     [id(12)] HRESULT ResetNextMenu();
 969     [id(13)] HRESULT FindOnWeb();
 970     [id(14)] HRESULT FindFilesOrFolders();
 971     [id(15)] HRESULT FindComputer();
 972     [id(16)] HRESULT FindPrinter();
 973     [id(17)] HRESULT FindPeople();
 974
 975     [id(18)] HRESULT GetSearchAssistantURL(
 976             [in] VARIANT_BOOL bSubstitute,
 977             [in] VARIANT_BOOL bCustomize,
 978             [out, retval] BSTR *pbstrValue);
 979
 980     [id(19)] HRESULT NotifySearchSettingsChanged();
 981
 982     [id(20), propput] HRESULT ASProvider([in] BSTR pProvider);
 983     [id(20), propget] HRESULT ASProvider([out, retval] BSTR *pProvider);
 984
 985     [id(21), propput] HRESULT ASSetting([in] int pSetting);
 986     [id(21), propget] HRESULT ASSetting([out, retval] int *pSetting);
 987
 988     [id(22)] HRESULT NETDetectNextNavigate();
 989     [id(23)] HRESULT PutFindText([in] BSTR FindText);
 990     [id(24), propget] HRESULT Version([out, retval] int *pVersion);
 991
 992     [id(25)] HRESULT EncodeString(
 993             [in] BSTR bstrValue,
 994             [in] BSTR bstrCharSet,
 995             [in] VARIANT_BOOL bUseUTF8,
 996             [out, retval] BSTR* pbstrResult);
 997 }
 998
 999 [
1000     odl,
1001     uuid(72423e8f-8011-11d2-be79-00a0c9a83da2),
1002     hidden,
1003     dual,
1004     oleautomation
1005 ]
1006 interface ISearchAssistantOC2 : ISearchAssistantOC {
1007     [id(26), propget] HRESULT ShowFindPrinter([out, retval] VARIANT_BOOL *pbShowFindPrinter);
1008 }
1009
1010 [
1011     odl,
1012     uuid(72423e8f-8011-11d2-be79-00a0c9a83da3),
1013     hidden,
1014     dual,
1015     oleautomation
1016 ]
1017 interface ISearchAssistantOC3 : ISearchAssistantOC2 {
1018     [id(27), propget] HRESULT SearchCompanionAvailable([out, retval] VARIANT_BOOL *pbAvailable);
1019
1020     [id(28), propput] HRESULT UseSearchCompanion([in] VARIANT_BOOL pbUseSC);
1021     [id(28), propget] HRESULT UseSearchCompanion([out, retval] VARIANT_BOOL *pbUseSC);
1022 }
1023
1024 [
1025     uuid(1611fdda-445b-11d2-85de-00C04fa35c89),
1026     hidden
1027 ]
1028 dispinterface _SearchAssistantEvents {
1029     properties:
1030     methods:
1031     [id(1)] void OnNextMenuSelect([in] long idItem);
1032     [id(2)] void OnNewSearch();
1033 }
1034
1035 [
1036     helpstring("SearchAssistantOC"),
1037     threading(apartment),
1038     progid("SearchAssistantOC.SearchAssistantOC.1"),
1039     vi_progid("SearchAssistantOC.SearchAssistantOC"),
1040     uuid(2e71fd0f-aab1-42c0-9146-6d2c4edcf07d),
1041     hidden
1042 ]
1043 coclass ShellSearchAssistantOC {
1044     [default] interface ISearchAssistantOC3;
1045     [default, source] dispinterface _SearchAssistantEvents;
1046 }
1047
1048 [
1049     threading(apartment),
1050     progid("SearchAssistantOC.SearchAssistantOC.1"),
1051     vi_progid("SearchAssistantOC.SearchAssistantOC"),
1052     uuid(b45ff030-4447-11d2-85de-00C04fa35c89),
1053     hidden
1054 ]
1055 coclass SearchAssistantOC {
1056     [default] interface ISearchAssistantOC3;
1057     [default, source] dispinterface _SearchAssistantEvents;
1058 }
1059
1060 } /* library */