2 * Shell Instance Objects - Add hot water and stir until dissolved.
4 * Copyright 2005 Michael Jung
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
21 /* 'Shell Instance Objects' allow you to add a node to the shell namespace
22 * (typically a shortcut to some location in the filesystem), just by setting
23 * some registry entries. This feature was introduced with win2k. Please
24 * search for 'Shell Instance Objects' on MSDN to get more information. */
38 #include "wine/unicode.h"
39 #include "wine/debug.h"
41 WINE_DEFAULT_DEBUG_CHANNEL(shdocvw);
43 #define CHARS_IN_GUID 39
45 /******************************************************************************
48 * Gives access to a registry key's values via the IPropertyBag interface.
50 typedef struct _RegistryPropertyBag {
51 IPropertyBag IPropertyBag_iface;
53 HKEY m_hInitPropertyBagKey;
54 } RegistryPropertyBag;
56 static inline RegistryPropertyBag *impl_from_IPropertyBag(IPropertyBag *iface)
58 return CONTAINING_RECORD(iface, RegistryPropertyBag, IPropertyBag_iface);
61 static HRESULT WINAPI RegistryPropertyBag_IPropertyBag_QueryInterface(IPropertyBag *iface,
62 REFIID riid, void **ppv)
64 RegistryPropertyBag *This = impl_from_IPropertyBag(iface);
66 TRACE("(iface=%p, riid=%s, ppv=%p)\n", iface, debugstr_guid(riid), ppv);
71 if (IsEqualIID(&IID_IUnknown, riid) || IsEqualIID(&IID_IPropertyBag, riid)) {
72 *ppv = &This->IPropertyBag_iface;
78 IUnknown_AddRef((IUnknown*)*ppv);
82 static ULONG WINAPI RegistryPropertyBag_IPropertyBag_AddRef(IPropertyBag *iface)
84 RegistryPropertyBag *This = impl_from_IPropertyBag(iface);
87 TRACE("(iface=%p)\n", iface);
89 cRef = InterlockedIncrement(&This->m_cRef);
97 static ULONG WINAPI RegistryPropertyBag_IPropertyBag_Release(IPropertyBag *iface)
99 RegistryPropertyBag *This = impl_from_IPropertyBag(iface);
102 TRACE("(iface=%p)\n", iface);
104 cRef = InterlockedDecrement(&This->m_cRef);
107 TRACE("Destroying This=%p)\n", This);
108 RegCloseKey(This->m_hInitPropertyBagKey);
110 SHDOCVW_UnlockModule();
116 static HRESULT WINAPI RegistryPropertyBag_IPropertyBag_Read(IPropertyBag *iface,
117 LPCOLESTR pwszPropName, VARIANT *pVar, IErrorLog *pErrorLog)
119 RegistryPropertyBag *This = impl_from_IPropertyBag(iface);
121 DWORD dwType, cbData;
123 VARTYPE vtDst = V_VT(pVar);
126 TRACE("(iface=%p, pwszPropName=%s, pVar=%p, pErrorLog=%p)\n", iface, debugstr_w(pwszPropName),
129 res = RegQueryValueExW(This->m_hInitPropertyBagKey, pwszPropName, NULL, &dwType, NULL, &cbData);
130 if (res != ERROR_SUCCESS)
133 pwszValue = heap_alloc(cbData);
135 return E_OUTOFMEMORY;
137 res = RegQueryValueExW(This->m_hInitPropertyBagKey, pwszPropName, NULL, &dwType,
138 (LPBYTE)pwszValue, &cbData);
139 if (res != ERROR_SUCCESS) {
140 heap_free(pwszValue);
144 V_VT(pVar) = VT_BSTR;
145 V_BSTR(pVar) = SysAllocString(pwszValue);
146 heap_free(pwszValue);
148 if (vtDst != VT_BSTR) {
149 hr = VariantChangeTypeEx(pVar, pVar, LOCALE_SYSTEM_DEFAULT, 0, vtDst);
151 SysFreeString(V_BSTR(pVar));
157 static HRESULT WINAPI RegistryPropertyBag_IPropertyBag_Write(IPropertyBag *iface,
158 LPCOLESTR pwszPropName, VARIANT *pVar)
160 FIXME("(iface=%p, pwszPropName=%s, pVar=%p) stub\n", iface, debugstr_w(pwszPropName), pVar);
164 static const IPropertyBagVtbl RegistryPropertyBag_IPropertyBagVtbl = {
165 RegistryPropertyBag_IPropertyBag_QueryInterface,
166 RegistryPropertyBag_IPropertyBag_AddRef,
167 RegistryPropertyBag_IPropertyBag_Release,
168 RegistryPropertyBag_IPropertyBag_Read,
169 RegistryPropertyBag_IPropertyBag_Write
172 static HRESULT RegistryPropertyBag_Constructor(HKEY hInitPropertyBagKey, REFIID riid, LPVOID *ppvObject) {
174 RegistryPropertyBag *pRegistryPropertyBag;
176 TRACE("(hInitPropertyBagKey=%p, riid=%s, ppvObject=%p)\n", hInitPropertyBagKey,
177 debugstr_guid(riid), ppvObject);
179 pRegistryPropertyBag = heap_alloc(sizeof(RegistryPropertyBag));
180 if (pRegistryPropertyBag) {
181 pRegistryPropertyBag->IPropertyBag_iface.lpVtbl = &RegistryPropertyBag_IPropertyBagVtbl;
182 pRegistryPropertyBag->m_cRef = 0;
183 pRegistryPropertyBag->m_hInitPropertyBagKey = hInitPropertyBagKey;
185 /* The clasping AddRef/Release is for the case that QueryInterface fails, which will result
186 * in a reference count of 0 in the Release call, which will result in object destruction.*/
187 IPropertyBag_AddRef(&pRegistryPropertyBag->IPropertyBag_iface);
188 hr = IPropertyBag_QueryInterface(&pRegistryPropertyBag->IPropertyBag_iface, riid, ppvObject);
189 IPropertyBag_Release(&pRegistryPropertyBag->IPropertyBag_iface);
195 /******************************************************************************
196 * InstanceObjectFactory
197 * Builds Instance Objects and asks them to initialize themselves based on the
198 * values of a PropertyBag.
200 typedef struct _InstanceObjectFactory {
201 IClassFactory IClassFactory_iface;
203 CLSID m_clsidInstance; /* CLSID of the objects to create. */
204 IPropertyBag *m_pPropertyBag; /* PropertyBag to initialize those objects. */
205 } InstanceObjectFactory;
207 static inline InstanceObjectFactory *impl_from_IClassFactory(IClassFactory *iface)
209 return CONTAINING_RECORD(iface, InstanceObjectFactory, IClassFactory_iface);
212 static HRESULT WINAPI InstanceObjectFactory_IClassFactory_QueryInterface(IClassFactory *iface,
213 REFIID riid, void **ppv)
215 InstanceObjectFactory *This = impl_from_IClassFactory(iface);
217 TRACE("iface=%p, riid=%s, ppv=%p)\n", iface, debugstr_guid(riid), ppv);
222 if (IsEqualIID(&IID_IUnknown, riid) || IsEqualIID(&IID_IClassFactory, riid)) {
223 *ppv = &This->IClassFactory_iface;
226 return E_NOINTERFACE;
229 IUnknown_AddRef((IUnknown*)*ppv);
233 static ULONG WINAPI InstanceObjectFactory_IClassFactory_AddRef(IClassFactory *iface)
235 InstanceObjectFactory *This = impl_from_IClassFactory(iface);
238 TRACE("(iface=%p)\n", iface);
240 cRef = InterlockedIncrement(&This->m_cRef);
243 IClassFactory_LockServer(iface, TRUE);
248 static ULONG WINAPI InstanceObjectFactory_IClassFactory_Release(IClassFactory *iface)
250 InstanceObjectFactory *This = impl_from_IClassFactory(iface);
253 TRACE("(iface=%p)\n", iface);
255 cRef = InterlockedDecrement(&This->m_cRef);
258 IClassFactory_LockServer(iface, FALSE);
259 IPropertyBag_Release(This->m_pPropertyBag);
266 static HRESULT WINAPI InstanceObjectFactory_IClassFactory_CreateInstance(IClassFactory *iface,
267 IUnknown *pUnkOuter, REFIID riid, LPVOID *ppvObj)
269 InstanceObjectFactory *This = impl_from_IClassFactory(iface);
270 IPersistPropertyBag *pPersistPropertyBag;
273 TRACE("(pUnkOuter=%p, riid=%s, ppvObj=%p)\n", pUnkOuter, debugstr_guid(riid), ppvObj);
275 hr = CoCreateInstance(&This->m_clsidInstance, NULL, CLSCTX_INPROC_SERVER,
276 &IID_IPersistPropertyBag, (LPVOID*)&pPersistPropertyBag);
278 TRACE("Failed to create instance of %s. hr = %08x\n",
279 debugstr_guid(&This->m_clsidInstance), hr);
283 hr = IPersistPropertyBag_Load(pPersistPropertyBag, This->m_pPropertyBag, NULL);
285 TRACE("Failed to initialize object from PropertyBag: hr = %08x\n", hr);
286 IPersistPropertyBag_Release(pPersistPropertyBag);
290 hr = IPersistPropertyBag_QueryInterface(pPersistPropertyBag, riid, ppvObj);
291 IPersistPropertyBag_Release(pPersistPropertyBag);
296 static HRESULT WINAPI InstanceObjectFactory_IClassFactory_LockServer(IClassFactory *iface,
299 TRACE("(iface=%p, fLock=%d) stub\n", iface, fLock);
302 SHDOCVW_LockModule();
304 SHDOCVW_UnlockModule();
309 static const IClassFactoryVtbl InstanceObjectFactory_IClassFactoryVtbl = {
310 InstanceObjectFactory_IClassFactory_QueryInterface,
311 InstanceObjectFactory_IClassFactory_AddRef,
312 InstanceObjectFactory_IClassFactory_Release,
313 InstanceObjectFactory_IClassFactory_CreateInstance,
314 InstanceObjectFactory_IClassFactory_LockServer
317 static HRESULT InstanceObjectFactory_Constructor(REFCLSID rclsid, IPropertyBag *pPropertyBag,
318 REFIID riid, LPVOID *ppvObject)
320 InstanceObjectFactory *pInstanceObjectFactory;
323 TRACE("(RegistryPropertyBag=%p, riid=%s, ppvObject=%p)\n", pPropertyBag,
324 debugstr_guid(riid), ppvObject);
326 pInstanceObjectFactory = heap_alloc(sizeof(InstanceObjectFactory));
327 if (pInstanceObjectFactory) {
328 pInstanceObjectFactory->IClassFactory_iface.lpVtbl = &InstanceObjectFactory_IClassFactoryVtbl;
329 pInstanceObjectFactory->m_cRef = 0;
330 pInstanceObjectFactory->m_clsidInstance = *rclsid;
331 pInstanceObjectFactory->m_pPropertyBag = pPropertyBag;
332 IPropertyBag_AddRef(pPropertyBag);
334 IClassFactory_AddRef(&pInstanceObjectFactory->IClassFactory_iface);
335 hr = IClassFactory_QueryInterface(&pInstanceObjectFactory->IClassFactory_iface,
337 IClassFactory_Release(&pInstanceObjectFactory->IClassFactory_iface);
343 /******************************************************************************
344 * SHDOCVW_GetShellInstanceObjectClassObject [Internal]
346 * Figure if there is a 'Shell Instance Object' conformant registry entry for
347 * the given CLSID and if so create and return a corresponding ClassObject.
350 * rclsid [I] CLSID of the 'Shell Instance Object'.
351 * riid [I] Desired interface. Only IClassFactory supported.
352 * ppvClassObj [O] The corresponding ClassObject.
356 * Failure: CLASS_E_CLASSNOTAVAILABLE
358 HRESULT SHDOCVW_GetShellInstanceObjectClassObject(REFCLSID rclsid, REFIID riid,
361 WCHAR wszInstanceKey[] = { 'C','L','S','I','D','\\','{','0','0','0','0','0','0','0','0','-',
362 '0','0','0','0','-','0','0','0','0','-','0','0','0','0','-','0','0','0','0','0','0','0','0',
363 '0','0','0','0','}','\\','I','n','s','t','a','n','c','e', 0 };
364 const WCHAR wszCLSID[] = { 'C','L','S','I','D',0 };
365 const WCHAR wszInitPropertyBag[] =
366 { 'I','n','i','t','P','r','o','p','e','r','t','y','B','a','g',0 };
367 WCHAR wszCLSIDInstance[CHARS_IN_GUID];
369 HKEY hInstanceKey, hInitPropertyBagKey;
370 DWORD dwType, cbBytes = sizeof(wszCLSIDInstance);
371 IPropertyBag *pInitPropertyBag;
375 TRACE("(rclsid=%s, riid=%s, ppvClassObject=%p)\n", debugstr_guid(rclsid), debugstr_guid(riid),
378 /* Figure if there is an 'Instance' subkey for the given CLSID and acquire a handle. */
379 if (!StringFromGUID2(rclsid, wszInstanceKey + 6, CHARS_IN_GUID))
380 return CLASS_E_CLASSNOTAVAILABLE;
381 wszInstanceKey[5+CHARS_IN_GUID] = '\\'; /* Repair the null-termination. */
382 if (ERROR_SUCCESS != RegOpenKeyExW(HKEY_CLASSES_ROOT, wszInstanceKey, 0, KEY_READ, &hInstanceKey))
383 /* If there is no 'Instance' subkey, then it's not a Shell Instance Object. */
384 return CLASS_E_CLASSNOTAVAILABLE;
386 if (ERROR_SUCCESS != RegQueryValueExW(hInstanceKey, wszCLSID, NULL, &dwType, (LPBYTE)wszCLSIDInstance, &cbBytes) ||
387 FAILED(CLSIDFromString(wszCLSIDInstance, &clsidInstance)))
389 /* 'Instance' should have a 'CLSID' value with a well-formed clsid-string. */
390 FIXME("Failed to infer instance CLSID! %s\n", debugstr_w(wszCLSIDInstance));
391 RegCloseKey(hInstanceKey);
392 return CLASS_E_CLASSNOTAVAILABLE;
395 /* Try to open the 'InitPropertyBag' subkey. */
396 res = RegOpenKeyExW(hInstanceKey, wszInitPropertyBag, 0, KEY_READ, &hInitPropertyBagKey);
397 RegCloseKey(hInstanceKey);
398 if (res != ERROR_SUCCESS) {
399 /* Besides 'InitPropertyBag's, shell instance objects might be initialized by streams.
400 * So this case might not be an error. */
401 TRACE("No InitPropertyBag key found!\n");
402 return CLASS_E_CLASSNOTAVAILABLE;
405 /* If the construction succeeds, the new RegistryPropertyBag is responsible for closing
406 * hInitPropertyBagKey. */
407 hr = RegistryPropertyBag_Constructor(hInitPropertyBagKey, &IID_IPropertyBag,
408 (LPVOID*)&pInitPropertyBag);
410 RegCloseKey(hInitPropertyBagKey);
414 /* Construct an Instance Object Factory, which creates objects of class 'clsidInstance'
415 * and asks them to initialize themselves with the help of the 'pInitiPropertyBag' */
416 hr = InstanceObjectFactory_Constructor(&clsidInstance, pInitPropertyBag, riid, ppvClassObj);
417 IPropertyBag_Release(pInitPropertyBag); /* The factory will hold a reference the bag. */