1 /**
2  * This file has no copyright assigned and is placed in the Public Domain.
3  * This file is part of the mingw-w64 runtime package.
4  * No warranty is given; refer to the file DISCLAIMER.PD within this package.
5  */
6 #ifndef _INC_FUNCTIONDISCOVERYAPI
7 #define _INC_FUNCTIONDISCOVERYAPI
8 #include <propsys.h>
9 #include <functiondiscoveryconstraints.h>
10 #if (_WIN32_WINNT >= 0x0600)
11 #ifdef __cplusplus
12 extern "C" {
13 #endif
14 
15 typedef DWORDLONG FDQUERYCONTEXT;
16 typedef struct IFunctionInstance IFunctionInstance;
17 
18 typedef enum tagQueryUpdateAction {
19   QUA_ADD      = 0,
20   QUA_REMOVE   = 1,
21   QUA_CHANGE   = 2
22 } QueryUpdateAction;
23 
24 typedef enum tagSystemVisibilityFlags {
25   SVF_SYSTEM   = 0,
26   SVF_USER     = 1
27 } SystemVisibilityFlags;
28 
29 #ifdef __cplusplus
30 }
31 #endif
32 
33 #include <functiondiscoverynotification.h>
34 
35 #define FD_EVENTID_SEARCHCOMPLETE 1000
36 #define FD_EVENTID_ASYNCTHREADEXIT 1001
37 #define FD_EVENTID_SEARCHSTART 1002
38 #define FD_EVENTID_IPADDRESSCHANGE 1003
39 
40 #undef  INTERFACE
41 #define INTERFACE IFunctionInstance
42 #ifdef __GNUC__
43 #warning COM interfaces layout in this header has not been verified.
44 #warning COM interfaces with incorrect layout may not work at all.
45 __MINGW_BROKEN_INTERFACE(INTERFACE)
46 #endif
DECLARE_INTERFACE_(IFunctionInstance,IUnknown)47 DECLARE_INTERFACE_(IFunctionInstance,IUnknown)
48 {
49     BEGIN_INTERFACE
50 
51     /* IUnknown methods */
52     STDMETHOD(QueryInterface)(THIS_ REFIID riid, void **ppvObject) PURE;
53     STDMETHOD_(ULONG, AddRef)(THIS) PURE;
54     STDMETHOD_(ULONG, Release)(THIS) PURE;
55 
56     /* IFunctionInstance methods */
57     STDMETHOD_(HRESULT,GetID)(THIS_ WCHAR **ppszCoMemIdentity) PURE;
58     STDMETHOD_(HRESULT,GetProviderInstanceID)(THIS_ WCHAR **ppszCoMemProviderInstanceID) PURE;
59     STDMETHOD_(HRESULT,OpenPropertyStore)(THIS_ DWORD dwStgAccess,IPropertyStore **ppIPropertyStore) PURE;
60     STDMETHOD_(HRESULT,GetCategory)(THIS_ WCHAR **ppszCoMemCategory,WCHAR **ppszCoMemSubCategory) PURE;
61     STDMETHOD_(HRESULT,QueryService)(THIS_ REFGUID guidService,REFGUID riid,void **ppv) PURE;
62     /* FIXME: genidl doesn't show QueryService */
63 
64     END_INTERFACE
65 };
66 #ifdef COBJMACROS
67 #define IFunctionInstance_QueryInterface(This,riid,ppvObject) (This)->lpVtbl->QueryInterface(This,riid,ppvObject)
68 #define IFunctionInstance_AddRef(This) (This)->lpVtbl->AddRef(This)
69 #define IFunctionInstance_Release(This) (This)->lpVtbl->Release(This)
70 #define IFunctionInstance_GetID(This,ppszCoMemIdentity) (This)->lpVtbl->GetID(This,ppszCoMemIdentity)
71 #define IFunctionInstance_GetProviderInstanceID(This,ppszCoMemProviderInstanceID) (This)->lpVtbl->GetProviderInstanceID(This,ppszCoMemProviderInstanceID)
72 #define IFunctionInstance_OpenPropertyStore(This,dwStgAccess,ppIPropertyStore) (This)->lpVtbl->OpenPropertyStore(This,dwStgAccess,ppIPropertyStore)
73 #define IFunctionInstance_GetCategory(This,ppszCoMemCategory,ppszCoMemSubCategory) (This)->lpVtbl->GetCategory(This,ppszCoMemCategory,ppszCoMemSubCategory)
74 #define IFunctionInstance_QueryService(This,guidService,riid,ppv) (This)->lpVtbl->QueryService(This,guidService,riid,ppv)
75 #endif /*COBJMACROS*/
76 
77 #undef  INTERFACE
78 #define INTERFACE IFunctionInstanceQuery
DECLARE_INTERFACE_(IFunctionInstanceQuery,IUnknown)79 DECLARE_INTERFACE_(IFunctionInstanceQuery,IUnknown)
80 {
81     BEGIN_INTERFACE
82 
83     /* IUnknown methods */
84     STDMETHOD(QueryInterface)(THIS_ REFIID riid, void **ppvObject) PURE;
85     STDMETHOD_(ULONG, AddRef)(THIS) PURE;
86     STDMETHOD_(ULONG, Release)(THIS) PURE;
87 
88     /* IFunctionInstanceQuery methods */
89     STDMETHOD_(HRESULT,Execute)(THIS_ IFunctionInstance **ppIFunctionInstance) PURE;
90 
91     END_INTERFACE
92 };
93 #ifdef COBJMACROS
94 #define IFunctionInstanceQuery_QueryInterface(This,riid,ppvObject) (This)->lpVtbl->QueryInterface(This,riid,ppvObject)
95 #define IFunctionInstanceQuery_AddRef(This) (This)->lpVtbl->AddRef(This)
96 #define IFunctionInstanceQuery_Release(This) (This)->lpVtbl->Release(This)
97 #define IFunctionInstanceQuery_Execute(This,ppIFunctionInstance) (This)->lpVtbl->Execute(This,ppIFunctionInstance)
98 #endif /*COBJMACROS*/
99 
100 #undef  INTERFACE
101 #define INTERFACE IFunctionInstanceCollection
102 #ifdef __GNUC__
103 #warning COM interfaces layout in this header has not been verified.
104 #warning COM interfaces with incorrect layout may not work at all.
105 __MINGW_BROKEN_INTERFACE(INTERFACE)
106 #endif
DECLARE_INTERFACE_(IFunctionInstanceCollection,IUnknown)107 DECLARE_INTERFACE_(IFunctionInstanceCollection,IUnknown)
108 {
109     BEGIN_INTERFACE
110 
111     /* IUnknown methods */
112     STDMETHOD(QueryInterface)(THIS_ REFIID riid, void **ppvObject) PURE;
113     STDMETHOD_(ULONG, AddRef)(THIS) PURE;
114     STDMETHOD_(ULONG, Release)(THIS) PURE;
115 
116     /* IFunctionInstanceCollection methods */
117     STDMETHOD_(HRESULT,GetCount)(THIS_ DWORD *pdwCount) PURE;
118     STDMETHOD_(HRESULT,Get)(THIS_ const WCHAR *pszInstanceIdentity,DWORD *pdwIndex,IFunctionInstance **ppIFunctionInstance) PURE;
119     STDMETHOD_(HRESULT,Item)(THIS_ DWORD dwIndex,IFunctionInstance **ppFunctionInstance) PURE;
120     STDMETHOD_(HRESULT,Add)(THIS_ IFunctionInstance *pIFunctionInstance) PURE;
121     STDMETHOD_(HRESULT,Remove)(THIS_ DWORD dwIndex,IFunctionInstance **ppIFunctionInstance) PURE;
122     STDMETHOD_(HRESULT,Delete)(THIS_ DWORD dwIndex) PURE;
123     STDMETHOD_(HRESULT,DeleteAll)(THIS) PURE;
124 
125     END_INTERFACE
126 };
127 #ifdef COBJMACROS
128 #define IFunctionInstanceCollection_QueryInterface(This,riid,ppvObject) (This)->lpVtbl->QueryInterface(This,riid,ppvObject)
129 #define IFunctionInstanceCollection_AddRef(This) (This)->lpVtbl->AddRef(This)
130 #define IFunctionInstanceCollection_Release(This) (This)->lpVtbl->Release(This)
131 #define IFunctionInstanceCollection_GetCount(This,pdwCount) (This)->lpVtbl->GetCount(This,pdwCount)
132 #define IFunctionInstanceCollection_Get(This,pszInstanceIdentity,pdwIndex,ppIFunctionInstance) (This)->lpVtbl->Get(This,pszInstanceIdentity,pdwIndex,ppIFunctionInstance)
133 #define IFunctionInstanceCollection_Item(This,dwIndex,ppFunctionInstance) (This)->lpVtbl->Item(This,dwIndex,ppFunctionInstance)
134 #define IFunctionInstanceCollection_Add(This,pIFunctionInstance) (This)->lpVtbl->Add(This,pIFunctionInstance)
135 #define IFunctionInstanceCollection_Remove(This,dwIndex,ppIFunctionInstance) (This)->lpVtbl->Remove(This,dwIndex,ppIFunctionInstance)
136 #define IFunctionInstanceCollection_Delete(This,dwIndex) (This)->lpVtbl->Delete(This,dwIndex)
137 #define IFunctionInstanceCollection_DeleteAll() (This)->lpVtbl->DeleteAll(This)
138 #endif /*COBJMACROS*/
139 
140 #undef  INTERFACE
141 #define INTERFACE IFunctionInstanceCollectionQuery
142 #ifdef __GNUC__
143 #warning COM interfaces layout in this header has not been verified.
144 #warning COM interfaces with incorrect layout may not work at all.
145 __MINGW_BROKEN_INTERFACE(INTERFACE)
146 #endif
DECLARE_INTERFACE_(IFunctionInstanceCollectionQuery,IUnknown)147 DECLARE_INTERFACE_(IFunctionInstanceCollectionQuery,IUnknown)
148 {
149     BEGIN_INTERFACE
150 
151     /* IUnknown methods */
152     STDMETHOD(QueryInterface)(THIS_ REFIID riid, void **ppvObject) PURE;
153     STDMETHOD_(ULONG, AddRef)(THIS) PURE;
154     STDMETHOD_(ULONG, Release)(THIS) PURE;
155 
156     /* IFunctionInstanceCollectionQuery methods */
157     STDMETHOD_(HRESULT,AddQueryConstraint)(THIS_ const WCHAR *pszConstraintName,const WCHAR *pszConstraintValue) PURE;
158     STDMETHOD_(HRESULT,AddPropertyConstraint)(THIS_ REFPROPERTYKEY Key,const PROPVARIANT *pv,PropertyConstraint enumPropertyConstraint) PURE;
159     STDMETHOD_(HRESULT,Execute)(THIS_ IFunctionInstanceCollection **ppIFunctionInstanceCollection) PURE;
160 
161     END_INTERFACE
162 };
163 #ifdef COBJMACROS
164 #define IFunctionInstanceCollectionQuery_QueryInterface(This,riid,ppvObject) (This)->lpVtbl->QueryInterface(This,riid,ppvObject)
165 #define IFunctionInstanceCollectionQuery_AddRef(This) (This)->lpVtbl->AddRef(This)
166 #define IFunctionInstanceCollectionQuery_Release(This) (This)->lpVtbl->Release(This)
167 #define IFunctionInstanceCollectionQuery_AddQueryConstraint(This,pszConstraintName,pszConstraintValue) (This)->lpVtbl->AddQueryConstraint(This,pszConstraintName,pszConstraintValue)
168 #define IFunctionInstanceCollectionQuery_AddPropertyConstraint(This,Key,pv,enumPropertyConstraint) (This)->lpVtbl->AddPropertyConstraint(This,Key,pv,enumPropertyConstraint)
169 #define IFunctionInstanceCollectionQuery_Execute(This,ppIFunctionInstanceCollection) (This)->lpVtbl->Execute(This,ppIFunctionInstanceCollection)
170 #endif /*COBJMACROS*/
171 
172 #undef  INTERFACE
173 #define INTERFACE IFunctionDiscovery
174 #ifdef __GNUC__
175 #warning COM interfaces layout in this header has not been verified.
176 #warning COM interfaces with incorrect layout may not work at all.
177 __MINGW_BROKEN_INTERFACE(INTERFACE)
178 #endif
DECLARE_INTERFACE_(IFunctionDiscovery,IUnknown)179 DECLARE_INTERFACE_(IFunctionDiscovery,IUnknown)
180 {
181     BEGIN_INTERFACE
182 
183     /* IUnknown methods */
184     STDMETHOD(QueryInterface)(THIS_ REFIID riid, void **ppvObject) PURE;
185     STDMETHOD_(ULONG, AddRef)(THIS) PURE;
186     STDMETHOD_(ULONG, Release)(THIS) PURE;
187 
188     /* IFunctionDiscovery methods */
189     STDMETHOD_(HRESULT,GetInstanceCollection)(THIS_ const WCHAR *pszCategory,const WCHAR *pszSubCategory,WINBOOL fIncludeAllSubCategories,IFunctionInstanceCollection **ppIFunctionInstanceCollection) PURE;
190     STDMETHOD_(HRESULT,GetInstance)(THIS_ const WCHAR *pszFunctionInstanceIdentity,IFunctionInstance **ppIFunctionInstance) PURE;
191     STDMETHOD_(HRESULT,CreateInstanceCollectionQuery)(THIS_ const WCHAR *pszCategory,const WCHAR *pszSubCategory,WINBOOL fIncludeAllSubCategories,IFunctionDiscoveryNotification *pIFunctionDiscoveryNotification,FDQUERYCONTEXT *pfdqcQueryContext,IFunctionInstanceCollectionQuery **ppIFunctionInstanceCollectionQuery) PURE;
192     STDMETHOD_(HRESULT,CreateInstanceQuery)(THIS_ const WCHAR *pszFunctionInstanceIdentity,IFunctionDiscoveryNotification *pIFunctionDiscoveryNotification,FDQUERYCONTEXT *pfdqcQueryContext,IFunctionInstanceQuery **ppIFunctionInstanceQuery) PURE;
193     STDMETHOD_(HRESULT,AddInstance)(THIS_ SystemVisibilityFlags enumSystemVisibility,const WCHAR *pszCategory,const WCHAR *pszSubCategory,const WCHAR *pszCategoryIdentity,IFunctionInstance **ppIFunctionInstance) PURE;
194     STDMETHOD_(HRESULT,RemoveInstance)(THIS_ SystemVisibilityFlags enumSystemVisibility,const WCHAR *pszCategory,const WCHAR *pszSubCategory,const WCHAR *pszCategoryIdentity) PURE;
195 
196     END_INTERFACE
197 };
198 #ifdef COBJMACROS
199 #define IFunctionDiscovery_QueryInterface(This,riid,ppvObject) (This)->lpVtbl->QueryInterface(This,riid,ppvObject)
200 #define IFunctionDiscovery_AddRef(This) (This)->lpVtbl->AddRef(This)
201 #define IFunctionDiscovery_Release(This) (This)->lpVtbl->Release(This)
202 #define IFunctionDiscovery_GetInstanceCollection(This,pszCategory,pszSubCategory,fIncludeAllSubCategories,ppIFunctionInstanceCollection) (This)->lpVtbl->GetInstanceCollection(This,pszCategory,pszSubCategory,fIncludeAllSubCategories,ppIFunctionInstanceCollection)
203 #define IFunctionDiscovery_GetInstance(This,pszFunctionInstanceIdentity,ppIFunctionInstance) (This)->lpVtbl->GetInstance(This,pszFunctionInstanceIdentity,ppIFunctionInstance)
204 #define IFunctionDiscovery_CreateInstanceCollectionQuery(This,pszCategory,pszSubCategory,fIncludeAllSubCategories,pIFunctionDiscoveryNotification,pfdqcQueryContext,ppIFunctionInstanceCollectionQuery) (This)->lpVtbl->CreateInstanceCollectionQuery(This,pszCategory,pszSubCategory,fIncludeAllSubCategories,pIFunctionDiscoveryNotification,pfdqcQueryContext,ppIFunctionInstanceCollectionQuery)
205 #define IFunctionDiscovery_CreateInstanceQuery(This,pszFunctionInstanceIdentity,pIFunctionDiscoveryNotification,pfdqcQueryContext,ppIFunctionInstanceQuery) (This)->lpVtbl->CreateInstanceQuery(This,pszFunctionInstanceIdentity,pIFunctionDiscoveryNotification,pfdqcQueryContext,ppIFunctionInstanceQuery)
206 #define IFunctionDiscovery_AddInstance(This,enumSystemVisibility,pszCategory,pszSubCategory,pszCategoryIdentity,ppIFunctionInstance) (This)->lpVtbl->AddInstance(This,enumSystemVisibility,pszCategory,pszSubCategory,pszCategoryIdentity,ppIFunctionInstance)
207 #define IFunctionDiscovery_RemoveInstance(This,enumSystemVisibility,pszCategory,pszSubCategory,pszCategoryIdentity) (This)->lpVtbl->RemoveInstance(This,enumSystemVisibility,pszCategory,pszSubCategory,pszCategoryIdentity)
208 #endif /*COBJMACROS*/
209 
210 #endif /*(_WIN32_WINNT >= 0x0600)*/
211 #endif /*_INC_FUNCTIONDISCOVERYAPI*/
212