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 ADJUST_THIS(c,m,p) ((c*)(((long)p)-(long)&(((c*)0)->lp##m##Vtbl)))
44 #define STATIC_CAST(i,p) ((i*)&p->lp##i##Vtbl)
45 #define CHARS_IN_GUID 39
47 /******************************************************************************
50 * Gives access to a registry key's values via the IPropertyBag interface.
52 typedef struct _RegistryPropertyBag {
53 const IPropertyBagVtbl *lpIPropertyBagVtbl;
55 HKEY m_hInitPropertyBagKey;
56 } RegistryPropertyBag;
58 static void RegistryPropertyBag_Destroy(RegistryPropertyBag *This) {
59 TRACE("This=%p)\n", This);
61 RegCloseKey(This->m_hInitPropertyBagKey);
65 static HRESULT WINAPI RegistryPropertyBag_IPropertyBag_QueryInterface(IPropertyBag *iface,
66 REFIID riid, void **ppv)
68 RegistryPropertyBag *This = ADJUST_THIS(RegistryPropertyBag, IPropertyBag, iface);
70 TRACE("(iface=%p, riid=%s, ppv=%p)\n", iface, debugstr_guid(riid), ppv);
75 if (IsEqualIID(&IID_IUnknown, riid) || IsEqualIID(&IID_IPropertyBag, riid)) {
76 *ppv = STATIC_CAST(IPropertyBag, This);
82 IUnknown_AddRef((IUnknown*)*ppv);
86 static ULONG WINAPI RegistryPropertyBag_IPropertyBag_AddRef(IPropertyBag *iface) {
87 RegistryPropertyBag *This = ADJUST_THIS(RegistryPropertyBag, IPropertyBag, iface);
90 TRACE("(iface=%p)\n", iface);
92 cRef = InterlockedIncrement(&This->m_cRef);
100 static ULONG WINAPI RegistryPropertyBag_IPropertyBag_Release(IPropertyBag *iface) {
101 RegistryPropertyBag *This = ADJUST_THIS(RegistryPropertyBag, IPropertyBag, iface);
104 TRACE("(iface=%p)\n", iface);
106 cRef = InterlockedDecrement(&This->m_cRef);
109 RegistryPropertyBag_Destroy(This);
110 SHDOCVW_UnlockModule();
116 static HRESULT WINAPI RegistryPropertyBag_IPropertyBag_Read(IPropertyBag *iface,
117 LPCOLESTR pwszPropName, VARIANT *pVar, IErrorLog *pErrorLog)
119 RegistryPropertyBag *This = ADJUST_THIS(RegistryPropertyBag, 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->lpIPropertyBagVtbl = &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(STATIC_CAST(IPropertyBag, pRegistryPropertyBag));
188 hr = IPropertyBag_QueryInterface(STATIC_CAST(IPropertyBag, pRegistryPropertyBag), riid, ppvObject);
189 IPropertyBag_Release(STATIC_CAST(IPropertyBag, pRegistryPropertyBag));
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 const IClassFactoryVtbl *lpIClassFactoryVtbl;
203 CLSID m_clsidInstance; /* CLSID of the objects to create. */
204 IPropertyBag *m_pPropertyBag; /* PropertyBag to initialize those objects. */
205 } InstanceObjectFactory;
207 static void InstanceObjectFactory_Destroy(InstanceObjectFactory *This) {
208 IPropertyBag_Release(This->m_pPropertyBag);
212 static HRESULT WINAPI InstanceObjectFactory_IClassFactory_QueryInterface(IClassFactory *iface,
213 REFIID riid, LPVOID* ppv)
215 InstanceObjectFactory *This = ADJUST_THIS(InstanceObjectFactory, 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 = STATIC_CAST(IClassFactory, This);
226 return E_NOINTERFACE;
229 IUnknown_AddRef((IUnknown*)*ppv);
233 static ULONG WINAPI InstanceObjectFactory_IClassFactory_AddRef(IClassFactory *iface)
235 InstanceObjectFactory *This = ADJUST_THIS(InstanceObjectFactory, 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 = ADJUST_THIS(InstanceObjectFactory, IClassFactory, iface);
253 TRACE("(iface=%p)\n", iface);
255 cRef = InterlockedDecrement(&This->m_cRef);
258 IClassFactory_LockServer(iface, FALSE);
259 InstanceObjectFactory_Destroy(This);
265 static HRESULT WINAPI InstanceObjectFactory_IClassFactory_CreateInstance(IClassFactory *iface,
266 IUnknown *pUnkOuter, REFIID riid, LPVOID *ppvObj)
268 InstanceObjectFactory *This = ADJUST_THIS(InstanceObjectFactory, IClassFactory, iface);
269 IPersistPropertyBag *pPersistPropertyBag;
272 TRACE("(pUnkOuter=%p, riid=%s, ppvObj=%p)\n", pUnkOuter, debugstr_guid(riid), ppvObj);
274 hr = CoCreateInstance(&This->m_clsidInstance, NULL, CLSCTX_INPROC_SERVER,
275 &IID_IPersistPropertyBag, (LPVOID*)&pPersistPropertyBag);
277 TRACE("Failed to create instance of %s. hr = %08x\n",
278 debugstr_guid(&This->m_clsidInstance), hr);
282 hr = IPersistPropertyBag_Load(pPersistPropertyBag, This->m_pPropertyBag, NULL);
284 TRACE("Failed to initialize object from ProperyBag: hr = %08x\n", hr);
285 IPersistPropertyBag_Release(pPersistPropertyBag);
289 hr = IPersistPropertyBag_QueryInterface(pPersistPropertyBag, riid, ppvObj);
290 IPersistPropertyBag_Release(pPersistPropertyBag);
295 static HRESULT WINAPI InstanceObjectFactory_IClassFactory_LockServer(IClassFactory *iface,
298 TRACE("(iface=%p, fLock=%d) stub\n", iface, fLock);
301 SHDOCVW_LockModule();
303 SHDOCVW_UnlockModule();
308 static const IClassFactoryVtbl InstanceObjectFactory_IClassFactoryVtbl = {
309 InstanceObjectFactory_IClassFactory_QueryInterface,
310 InstanceObjectFactory_IClassFactory_AddRef,
311 InstanceObjectFactory_IClassFactory_Release,
312 InstanceObjectFactory_IClassFactory_CreateInstance,
313 InstanceObjectFactory_IClassFactory_LockServer
316 static HRESULT InstanceObjectFactory_Constructor(REFCLSID rclsid, IPropertyBag *pPropertyBag,
317 REFIID riid, LPVOID *ppvObject)
319 InstanceObjectFactory *pInstanceObjectFactory;
322 TRACE("(RegistryPropertyBag=%p, riid=%s, ppvObject=%p)\n", pPropertyBag,
323 debugstr_guid(riid), ppvObject);
325 pInstanceObjectFactory = heap_alloc(sizeof(InstanceObjectFactory));
326 if (pInstanceObjectFactory) {
327 pInstanceObjectFactory->lpIClassFactoryVtbl = &InstanceObjectFactory_IClassFactoryVtbl;
328 pInstanceObjectFactory->m_cRef = 0;
329 pInstanceObjectFactory->m_clsidInstance = *rclsid;
330 pInstanceObjectFactory->m_pPropertyBag = pPropertyBag;
331 IPropertyBag_AddRef(pPropertyBag);
333 IClassFactory_AddRef(STATIC_CAST(IClassFactory, pInstanceObjectFactory));
334 hr = IClassFactory_QueryInterface(STATIC_CAST(IClassFactory, pInstanceObjectFactory),
336 IClassFactory_Release(STATIC_CAST(IClassFactory, pInstanceObjectFactory));
342 /******************************************************************************
343 * SHDOCVW_GetShellInstanceObjectClassObject [Internal]
345 * Figure if there is a 'Shell Instance Object' conformant registry entry for
346 * the given CLSID and if so create and return a corresponding ClassObject.
349 * rclsid [I] CLSID of the 'Shell Instance Object'.
350 * riid [I] Desired interface. Only IClassFactory supported.
351 * ppvClassObj [O] The corresponding ClassObject.
355 * Failure: CLASS_E_CLASSNOTAVAILABLE
357 HRESULT SHDOCVW_GetShellInstanceObjectClassObject(REFCLSID rclsid, REFIID riid,
360 WCHAR wszInstanceKey[] = { 'C','L','S','I','D','\\','{','0','0','0','0','0','0','0','0','-',
361 '0','0','0','0','-','0','0','0','0','-','0','0','0','0','-','0','0','0','0','0','0','0','0',
362 '0','0','0','0','}','\\','I','n','s','t','a','n','c','e', 0 };
363 const WCHAR wszCLSID[] = { 'C','L','S','I','D',0 };
364 const WCHAR wszInitPropertyBag[] =
365 { 'I','n','i','t','P','r','o','p','e','r','t','y','B','a','g',0 };
366 WCHAR wszCLSIDInstance[CHARS_IN_GUID];
368 HKEY hInstanceKey, hInitPropertyBagKey;
369 DWORD dwType, cbBytes = sizeof(wszCLSIDInstance);
370 IPropertyBag *pInitPropertyBag;
374 TRACE("(rclsid=%s, riid=%s, ppvClassObject=%p)\n", debugstr_guid(rclsid), debugstr_guid(riid),
377 /* Figure if there is an 'Instance' subkey for the given CLSID and acquire a handle. */
378 if (!StringFromGUID2(rclsid, wszInstanceKey + 6, CHARS_IN_GUID) ||
379 !(wszInstanceKey[5+CHARS_IN_GUID]='\\') || /* Repair the null-termination. */
380 ERROR_SUCCESS != RegOpenKeyExW(HKEY_CLASSES_ROOT, wszInstanceKey, 0, KEY_READ, &hInstanceKey))
382 /* If there is no 'Instance' subkey, then it's not a Shell Instance Object. */
383 return CLASS_E_CLASSNOTAVAILABLE;
386 if (RegQueryValueExW(hInstanceKey, wszCLSID, NULL, &dwType, (LPBYTE)wszCLSIDInstance, &cbBytes)
387 != ERROR_SUCCESS || 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 * hInitProperyBagKey. */
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. */