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
12extern "C" {
13#endif
14
15typedef DWORDLONG FDQUERYCONTEXT;
16typedef struct IFunctionInstance IFunctionInstance;
17
18typedef enum tagQueryUpdateAction {
19  QUA_ADD      = 0,
20  QUA_REMOVE   = 1,
21  QUA_CHANGE   = 2
22} QueryUpdateAction;
23
24typedef 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
47DECLARE_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
79DECLARE_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
107DECLARE_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
147DECLARE_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
179DECLARE_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