mpr: Don't stop enumeration on the first failing network provider.
[wine.git] / include / netfw.idl
blobcf03b820754378afe51bff531b4dfb1f0c686bf8
1 /*
2 * Copyright 2007 Jeff Latimer
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2.1 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the Free Software
16 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
18 *****************************************************************************
20 * The firewall management interface
24 import "icftypes.idl";
25 import "oaidl.idl";
28 object,
29 uuid(A6207B2E-7CDD-426A-951E-5E1CBC5AFEAD),
30 dual
32 interface INetFwIcmpSettings : IDispatch
34 [id(1), propget]
35 HRESULT AllowOutboundDestinationUnreachable([out, retval] VARIANT_BOOL* allow);
37 [id(1), propput]
38 HRESULT AllowOutboundDestinationUnreachable( [in] VARIANT_BOOL allow );
40 [id(2), propget]
41 HRESULT AllowRedirect( [out, retval] VARIANT_BOOL* allow );
43 [id(2), propput]
44 HRESULT AllowRedirect( [in] VARIANT_BOOL allow );
46 [id(3), propget]
47 HRESULT AllowInboundEchoRequest( [out, retval] VARIANT_BOOL* allow );
49 [id(3), propput]
50 HRESULT AllowInboundEchoRequest( [in] VARIANT_BOOL allow );
52 [id(4), propget]
53 HRESULT AllowOutboundTimeExceeded( [out, retval] VARIANT_BOOL* allow );
55 [id(4), propput]
56 HRESULT AllowOutboundTimeExceeded( [in] VARIANT_BOOL allow );
58 [id(5), propget]
59 HRESULT AllowOutboundParameterProblem( [out, retval] VARIANT_BOOL* allow );
61 [id(5), propput]
62 HRESULT AllowOutboundParameterProblem( [in] VARIANT_BOOL allow );
64 [id(6), propget]
65 HRESULT AllowOutboundSourceQuench( [out, retval] VARIANT_BOOL* allow );
67 [id(6), propput]
68 HRESULT AllowOutboundSourceQuench( [in] VARIANT_BOOL allow );
70 [id(7), propget]
71 HRESULT AllowInboundRouterRequest( [out, retval] VARIANT_BOOL* allow );
73 [id(7), propput]
74 HRESULT AllowInboundRouterRequest( [in] VARIANT_BOOL allow );
76 [id(8), propget]
77 HRESULT AllowInboundTimestampRequest( [out, retval] VARIANT_BOOL* allow );
79 [id(8), propput]
80 HRESULT AllowInboundTimestampRequest( [in] VARIANT_BOOL allow );
82 [id(9), propget]
83 HRESULT AllowInboundMaskRequest( [out, retval] VARIANT_BOOL* allow );
85 [id(9), propput]
86 HRESULT AllowInboundMaskRequest( [in] VARIANT_BOOL allow );
88 [id(10), propget]
89 HRESULT AllowOutboundPacketTooBig( [out, retval] VARIANT_BOOL* allow );
91 [id(10), propput]
92 HRESULT AllowOutboundPacketTooBig( [in] VARIANT_BOOL allow );
96 object,
97 uuid(E0483BA0-47FF-4D9C-A6D6-7741D0B195F7),
98 dual
100 interface INetFwOpenPort : IDispatch
102 [id(1), propget]
103 HRESULT Name( [out, retval] BSTR* name );
105 [id(1), propput]
106 HRESULT Name( [in] BSTR name );
108 [id(2), propget]
109 HRESULT IpVersion( [out, retval] NET_FW_IP_VERSION* ipVersion );
111 [id(2), propput]
112 HRESULT IpVersion( [in] NET_FW_IP_VERSION ipVersion );
114 [id(3), propget]
115 HRESULT Protocol( [out, retval] NET_FW_IP_PROTOCOL* ipProtocol );
117 [id(3), propput]
118 HRESULT Protocol( [in] NET_FW_IP_PROTOCOL ipProtocol );
120 [id(4), propget]
121 HRESULT Port( [out, retval] LONG* portNumber );
123 [id(4), propput]
124 HRESULT Port( [in] LONG portNumber );
126 [id(5), propget]
127 HRESULT Scope( [out, retval] NET_FW_SCOPE* scope );
129 [id(5), propput]
130 HRESULT Scope( [in] NET_FW_SCOPE scope );
132 [id(6), propget]
133 HRESULT RemoteAddresses( [out, retval] BSTR* remoteAddrs );
135 [id(6), propput]
136 HRESULT RemoteAddresses( [in] BSTR remoteAddrs );
138 [id(7), propget]
139 HRESULT Enabled( [out, retval] VARIANT_BOOL* enabled );
141 [id(7), propput]
142 HRESULT Enabled( [in] VARIANT_BOOL enabled );
144 [id(8), propget]
145 HRESULT BuiltIn( [out, retval] VARIANT_BOOL* builtIn );
149 object,
150 uuid(C0E9D7FA-E07E-430A-B19A-090CE82D92E2),
151 dual
153 interface INetFwOpenPorts : IDispatch
155 [id(1), propget]
156 HRESULT Count( [out, retval] long* count );
158 [id(2)]
159 HRESULT Add( [in] INetFwOpenPort* port );
161 [id(3)]
162 HRESULT Remove( [in] LONG portNumber, [in] NET_FW_IP_PROTOCOL ipProtocol );
164 [id(4)]
165 HRESULT Item( [in] LONG portNumber, [in] NET_FW_IP_PROTOCOL ipProtocol,
166 [out, retval] INetFwOpenPort** openPort );
168 [id(DISPID_NEWENUM), propget, restricted]
169 HRESULT _NewEnum( [out, retval] IUnknown** newEnum );
173 object,
174 uuid(79FD57C8-908E-4A36-9888-D5B3F0A444CF),
175 dual
177 interface INetFwService : IDispatch
179 [id(1), propget]
180 HRESULT Name( [out, retval] BSTR* name );
182 [id(2), propget]
183 HRESULT Type( [out, retval] NET_FW_SERVICE_TYPE* type );
185 [id(3), propget]
186 HRESULT Customized( [out, retval] VARIANT_BOOL* customized );
188 [id(4), propget]
189 HRESULT IpVersion( [out, retval] NET_FW_IP_VERSION* ipVersion );
191 [id(4), propput]
192 HRESULT IpVersion( [in] NET_FW_IP_VERSION ipVersion );
194 [id(5), propget]
195 HRESULT Scope( [out, retval] NET_FW_SCOPE* scope );
197 [id(5), propput]
198 HRESULT Scope( [in] NET_FW_SCOPE scope );
200 [id(6), propget]
201 HRESULT RemoteAddresses( [out, retval] BSTR* remoteAddrs );
203 [id(6), propput]
204 HRESULT RemoteAddresses( [in] BSTR remoteAddrs );
206 [id(7), propget]
207 HRESULT Enabled( [out, retval] VARIANT_BOOL* enabled );
209 [id(7), propput]
210 HRESULT Enabled( [in] VARIANT_BOOL enabled );
212 [id(8), propget]
213 HRESULT GloballyOpenPorts( [out, retval] INetFwOpenPorts** openPorts );
217 object,
218 uuid(79649BB4-903E-421B-94C9-79848E79F6EE),
219 dual
221 interface INetFwServices : IDispatch
223 [id(1), propget]
224 HRESULT Count( [out, retval] long* count );
226 [id(2)]
227 HRESULT Item( [in] NET_FW_SERVICE_TYPE svcType,
228 [out, retval] INetFwService** service );
230 [id(DISPID_NEWENUM), propget, restricted]
231 HRESULT _NewEnum( [out, retval] IUnknown** newEnum );
235 object,
236 uuid(B5E64FFA-C2C5-444E-A301-FB5E00018050),
237 dual
239 interface INetFwAuthorizedApplication : IDispatch
241 [id(1), propget]
242 HRESULT Name( [out, retval] BSTR* name );
244 [id(1), propput]
245 HRESULT Name( [in] BSTR name );
247 [id(2), propget]
248 HRESULT ProcessImageFileName( [out, retval] BSTR* imageFileName );
250 [id(2), propput]
251 HRESULT ProcessImageFileName( [in] BSTR imageFileName );
253 [id(3), propget]
254 HRESULT IpVersion( [out, retval] NET_FW_IP_VERSION* ipVersion );
256 [id(3), propput]
257 HRESULT IpVersion( [in] NET_FW_IP_VERSION ipVersion );
259 [id(4), propget]
260 HRESULT Scope( [out, retval] NET_FW_SCOPE* scope );
262 [id(4), propput]
263 HRESULT Scope( [in] NET_FW_SCOPE scope );
265 [id(5), propget]
266 HRESULT RemoteAddresses( [out, retval] BSTR* remoteAddrs );
268 [id(5), propput]
269 HRESULT RemoteAddresses( [in] BSTR remoteAddrs );
271 [id(6), propget]
272 HRESULT Enabled( [out, retval] VARIANT_BOOL* enabled );
274 [id(6), propput]
275 HRESULT Enabled( [in] VARIANT_BOOL enabled );
279 object,
280 uuid(D4BECDDF-6F73-4A83-B832-9C66874CD20E),
281 dual
283 interface INetFwRemoteAdminSettings : IDispatch
285 [id(1), propget]
286 HRESULT IpVersion( [out, retval] NET_FW_IP_VERSION* ipVersion );
288 [id(1), propput]
289 HRESULT IpVersion( [in] NET_FW_IP_VERSION ipVersion );
291 [id(2), propget]
292 HRESULT Scope( [out, retval] NET_FW_SCOPE* scope );
294 [id(2), propput]
295 HRESULT Scope( [in] NET_FW_SCOPE scope );
297 [id(3), propget]
298 HRESULT RemoteAddresses( [out, retval] BSTR* remoteAddrs );
300 [id(3), propput]
301 HRESULT RemoteAddresses( [in] BSTR remoteAddrs );
303 [id(4), propget]
304 HRESULT Enabled( [out, retval] VARIANT_BOOL* enabled );
306 [id(4), propput]
307 HRESULT Enabled( [in] VARIANT_BOOL enabled );
312 object,
313 uuid(644EFD52-CCF9-486C-97A2-39F352570B30),
314 dual
316 interface INetFwAuthorizedApplications : IDispatch
318 [id(1), propget]
319 HRESULT Count( [out, retval] long* count );
321 [id(2)]
322 HRESULT Add( [in] INetFwAuthorizedApplication* app );
324 [id(3)]
325 HRESULT Remove( [in] BSTR imageFileName );
327 [id(4)]
328 HRESULT Item( [in] BSTR imageFileName,
329 [out, retval] INetFwAuthorizedApplication** app );
331 [id(DISPID_NEWENUM), propget, restricted]
332 HRESULT _NewEnum( [out, retval] IUnknown** newEnum );
336 local,
337 object,
338 uuid(af230d27-baba-4e42-aced-f524f22cfce2),
339 dual
341 interface INetFwRule : IDispatch
343 [id(1), propget]
344 HRESULT Name( [out, retval] BSTR *name );
345 [id(1), propput]
346 HRESULT Name( [in] BSTR name );
348 [id(2), propget]
349 HRESULT Description( [out, retval] BSTR* desc );
350 [id(2), propput]
351 HRESULT Description( [in] BSTR desc );
353 [id(3), propget]
354 HRESULT ApplicationName( [out, retval] BSTR *imagename );
355 [id(3), propput]
356 HRESULT ApplicationName( [in] BSTR imagename );
358 [id(4), propget]
359 HRESULT ServiceName( [out, retval] BSTR *service );
360 [id(4), propput]
361 HRESULT ServiceName( [in] BSTR service );
363 [id(5), propget]
364 HRESULT Protocol( [out, retval] long* protocol );
365 [id(5), propput]
366 HRESULT Protocol( [in] long protocol );
368 [id(6), propget]
369 HRESULT LocalPorts( [out, retval] BSTR* ports );
370 [id(6), propput]
371 HRESULT LocalPorts( [in] BSTR ports );
373 [id(7), propget]
374 HRESULT RemotePorts( [out, retval] BSTR *ports );
375 [id(7), propput]
376 HRESULT RemotePorts( [in] BSTR ports );
378 [id(8), propget]
379 HRESULT LocalAddresses([out, retval] BSTR* address );
380 [id(8), propput]
381 HRESULT LocalAddresses([in] BSTR address);
383 [id(9), propget]
384 HRESULT RemoteAddresses( [out, retval] BSTR* address );
385 [id(9), propput]
386 HRESULT RemoteAddresses( [in] BSTR address );
388 [id(10), propget]
389 HRESULT IcmpTypesAndCodes( [out, retval] BSTR *codes );
390 [id(10), propput]
391 HRESULT IcmpTypesAndCodes( [in] BSTR codes );
393 [id(11), propget]
394 HRESULT Direction( [out, retval] NET_FW_RULE_DIRECTION* dir );
395 [id(11), propput]
396 HRESULT Direction( [in] NET_FW_RULE_DIRECTION dir );
398 [id(12), propget]
399 HRESULT Interfaces( [out, retval] VARIANT* interfaces );
400 [id(12), propput]
401 HRESULT Interfaces( [in] VARIANT interfaces );
403 [id(13), propget]
404 HRESULT InterfaceTypes( [out, retval] BSTR* types );
405 [id(13), propput]
406 HRESULT InterfaceTypes( [in] BSTR types );
408 [id(14), propget]
409 HRESULT Enabled( [out, retval] VARIANT_BOOL* enabled );
410 [id(14), propput]
411 HRESULT Enabled( [in] VARIANT_BOOL enabled );
413 [id(15), propget]
414 HRESULT Grouping( [out, retval] BSTR* context );
415 [id(15), propput]
416 HRESULT Grouping( [in] BSTR context );
418 [id(16), propget]
419 HRESULT Profiles( [out, retval] long* profiles );
420 [id(16), propput]
421 HRESULT Profiles( [in] long profiles );
423 [id(17), propget]
424 HRESULT EdgeTraversal( [out, retval] VARIANT_BOOL* enabled );
425 [id(17), propput]
426 HRESULT EdgeTraversal( [in] VARIANT_BOOL enabled );
428 [id(18), propget]
429 HRESULT Action( [out, retval] NET_FW_ACTION* action );
430 [id(18), propput]
431 HRESULT Action( [in] NET_FW_ACTION action );
435 local,
436 object,
437 uuid(9c4c6277-5027-441e-afae-ca1f542da009),
438 dual
440 interface INetFwRules : IDispatch
442 [id(1), propget]
443 HRESULT Count( [out, retval] long* count );
445 [id(2)]
446 HRESULT Add( [in] INetFwRule* rule );
448 [id(3)]
449 HRESULT Remove( [in] BSTR name );
451 [id(4)]
452 HRESULT Item( [in] BSTR name, [out, retval] INetFwRule** rule );
454 [id(DISPID_NEWENUM), propget, restricted]
455 HRESULT _NewEnum( [out, retval] IUnknown** newEnum );
459 local,
460 object,
461 uuid(8267bbe3-f890-491c-b7b6-2db1ef0e5d2b),
462 dual
464 interface INetFwServiceRestriction : IDispatch
466 [id(1)]
467 HRESULT RestrictService( [in] BSTR serviceName, [in] BSTR appName,
468 [in] VARIANT_BOOL restrictService, [in] VARIANT_BOOL serviceSidRestricted );
470 [id(2)]
471 HRESULT ServiceRestricted( [in] BSTR serviceName, [in] BSTR appName,
472 [out, retval] VARIANT_BOOL* serviceRestricted );
474 [id(3), propget]
475 HRESULT Rules( [out, retval] INetFwRules** rules );
479 object,
480 uuid(174A0DDA-E9F9-449D-993B-21AB667CA456),
481 dual
483 interface INetFwProfile : IDispatch
485 [id(1), propget]
486 HRESULT Type( [out, retval] NET_FW_PROFILE_TYPE* type );
488 [id(2), propget]
489 HRESULT FirewallEnabled( [out, retval] VARIANT_BOOL* enabled );
491 [id(2), propput]
492 HRESULT FirewallEnabled( [in] VARIANT_BOOL enabled );
494 [id(3), propget]
495 HRESULT ExceptionsNotAllowed( [out, retval] VARIANT_BOOL* notAllowed );
497 [id(3), propput]
498 HRESULT ExceptionsNotAllowed( [in] VARIANT_BOOL notAllowed );
500 [id(4), propget]
501 HRESULT NotificationsDisabled( [out, retval] VARIANT_BOOL* disabled );
503 [id(4), propput]
504 HRESULT NotificationsDisabled( [in] VARIANT_BOOL disabled );
506 [id(5), propget]
507 HRESULT UnicastResponsesToMulticastBroadcastDisabled( [out, retval] VARIANT_BOOL* disabled );
509 [id(5), propput]
510 HRESULT UnicastResponsesToMulticastBroadcastDisabled( [in] VARIANT_BOOL disabled );
512 [id(6), propget]
513 HRESULT RemoteAdminSettings( [out, retval] INetFwRemoteAdminSettings** remoteAdminSettings );
515 [id(7), propget]
516 HRESULT IcmpSettings( [out, retval] INetFwIcmpSettings** icmpSettings );
518 [id(8), propget]
519 HRESULT GloballyOpenPorts( [out, retval] INetFwOpenPorts** openPorts );
521 [id(9), propget]
522 HRESULT Services( [out, retval] INetFwServices** services );
524 [id(10), propget]
525 HRESULT AuthorizedApplications( [out, retval] INetFwAuthorizedApplications** apps );
529 object,
530 uuid(D46D2478-9AC9-4008-9DC7-5563CE5536CC),
531 dual
533 interface INetFwPolicy : IDispatch
535 [id(1), propget]
536 HRESULT CurrentProfile( [out, retval] INetFwProfile** profile );
538 [id(2)]
539 HRESULT GetProfileByType( [in] NET_FW_PROFILE_TYPE profileType,
540 [out, retval] INetFwProfile** profile );
544 local,
545 object,
546 uuid(98325047-c671-4174-8d81-defcd3f03186),
547 dual
549 interface INetFwPolicy2 : IDispatch
551 [id(1), propget]
552 HRESULT CurrentProfileTypes( [out, retval] long *profile );
554 [id(2), propget]
555 HRESULT FirewallEnabled( [in] NET_FW_PROFILE_TYPE2 profileType, [out, retval] VARIANT_BOOL* enabled );
557 [id(2), propput]
558 HRESULT FirewallEnabled( [in] NET_FW_PROFILE_TYPE2 profileType, [in] VARIANT_BOOL enabled );
560 [id(3), propget]
561 HRESULT ExcludedInterfaces( [in] NET_FW_PROFILE_TYPE2 profileType, [out, retval] VARIANT *interfaces );
563 [id(3), propput]
564 HRESULT ExcludedInterfaces( [in] NET_FW_PROFILE_TYPE2 profileType, [in] VARIANT interfaces );
566 [id(4), propget]
567 HRESULT BlockAllInboundTraffic( [in] NET_FW_PROFILE_TYPE2 profileType, [out, retval] VARIANT_BOOL* block );
569 [id(4), propput]
570 HRESULT BlockAllInboundTraffic( [in] NET_FW_PROFILE_TYPE2 profileType, [in] VARIANT_BOOL block );
572 [id(5), propget]
573 HRESULT NotificationsDisabled( [in] NET_FW_PROFILE_TYPE2 profileType, [out, retval] VARIANT_BOOL* disabled );
574 [id(5), propput]
575 HRESULT NotificationsDisabled( [in] NET_FW_PROFILE_TYPE2 profileType, [in] VARIANT_BOOL disabled );
577 [id(6), propget]
578 HRESULT UnicastResponsesToMulticastBroadcastDisabled( [in] NET_FW_PROFILE_TYPE2 profileType,
579 [out, retval] VARIANT_BOOL* disabled );
580 [id(6), propput]
581 HRESULT UnicastResponsesToMulticastBroadcastDisabled( [in] NET_FW_PROFILE_TYPE2 profileType,
582 [in] VARIANT_BOOL disabled );
584 [id(7), propget]
585 HRESULT Rules( [out, retval] INetFwRules** rules );
587 [id(8), propget]
588 HRESULT ServiceRestriction( [out, retval] INetFwServiceRestriction **ServiceRestriction );
590 [id(9)]
591 HRESULT EnableRuleGroup( [in] long profileTypesBitmask, [in] BSTR group, [in] VARIANT_BOOL enable );
593 [id(10)]
594 HRESULT IsRuleGroupEnabled( [in] long profileTypesBitmask, [in] BSTR group, [out, retval] VARIANT_BOOL *enabled );
596 [id(11)]
597 HRESULT RestoreLocalFirewallDefaults();
599 [id(12), propget]
600 HRESULT DefaultInboundAction( [in] NET_FW_PROFILE_TYPE2 profileType, [out, retval] NET_FW_ACTION* action );
602 [id(12), propput]
603 HRESULT DefaultInboundAction( [in] NET_FW_PROFILE_TYPE2 profileType, [in] NET_FW_ACTION action );
605 [id(13), propget]
606 HRESULT DefaultOutboundAction( [in] NET_FW_PROFILE_TYPE2 profileType, [out, retval] NET_FW_ACTION* action );
608 [id(13), propput]
609 HRESULT DefaultOutboundAction( [in] NET_FW_PROFILE_TYPE2 profileType, [in] NET_FW_ACTION action );
611 [id(14), propget]
612 HRESULT IsRuleGroupCurrentlyEnabled( [in] BSTR group, [out, retval] VARIANT_BOOL* enabled );
614 [id(15), propget]
615 HRESULT LocalPolicyModifyState( [out, retval] NET_FW_MODIFY_STATE* modifyState );
619 object,
620 uuid(F7898AF5-CAC4-4632-A2EC-DA06E5111AF2),
621 dual
623 interface INetFwMgr : IDispatch
625 [id(1), propget]
626 HRESULT LocalPolicy( [out, retval] INetFwPolicy** localPolicy );
628 [id(2), propget]
629 HRESULT CurrentProfileType( [out, retval] NET_FW_PROFILE_TYPE* profileType );
631 [id(3)]
632 HRESULT RestoreDefaults();
634 [id(4)]
635 HRESULT IsPortAllowed( [in] BSTR imageFileName, [in] NET_FW_IP_VERSION ipVersion,
636 [in] LONG portNumber, [in] BSTR localAddress,
637 [in] NET_FW_IP_PROTOCOL ipProtocol, [out] VARIANT* allowed,
638 [out] VARIANT* restricted );
640 [id(5)]
641 HRESULT IsIcmpTypeAllowed( [in] NET_FW_IP_VERSION ipVersion, [in] BSTR localAddress,
642 [in] BYTE type, [out] VARIANT* allowed,
643 [out] VARIANT* restricted );
647 uuid(DB4F3345-3EF8-45ED-B976-25A6D3B81B71),
648 version(1.0)
650 library NetFwPublicTypeLib
652 importlib("stdole2.tlb");
653 interface INetFwRemoteAdminSettings;
654 interface INetFwIcmpSettings;
655 interface INetFwOpenPort;
656 interface INetFwOpenPorts;
657 interface INetFwService;
658 interface INetFwServices;
659 interface INetFwAuthorizedApplication;
660 interface INetFwAuthorizedApplications;
661 interface INetFwProfile;
662 interface INetFwPolicy;
663 interface INetFwPolicy2;
664 interface INetFwMgr;
667 uuid(0CA545C6-37AD-4A6C-BF92-9F7610067EF5)
669 coclass NetFwOpenPort
671 [default] interface INetFwOpenPort;
675 uuid(EC9846B3-2762-4A6B-A214-6ACB603462D2)
677 coclass NetFwAuthorizedApplication
679 [default] interface INetFwAuthorizedApplication;
683 uuid(304CE942-6E39-40D8-943A-B913C40C9CD4)
685 coclass NetFwMgr
687 [default] interface INetFwMgr;
691 uuid(e2b3c97f-6ae1-41ac-817a-f6f92166d7dd)
693 coclass NetFwPolicy2
695 [default] interface INetFwPolicy2;