2 * self-registerable dll functions for shell32.dll
4 * Copyright (C) 2003 John K. Hohm
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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
32 #include "wine/debug.h"
34 WINE_DEFAULT_DEBUG_CHANNEL(ole
);
37 * Near the bottom of this file are the exported DllRegisterServer and
38 * DllUnregisterServer, which make all this worthwhile.
41 /***********************************************************************
42 * interface for self-registering
44 struct regsvr_interface
46 IID
const *iid
; /* NULL for end of list */
47 LPCSTR name
; /* can be NULL to omit */
48 IID
const *base_iid
; /* can be NULL to omit */
49 int num_methods
; /* can be <0 to omit */
50 CLSID
const *ps_clsid
; /* can be NULL to omit */
51 CLSID
const *ps_clsid32
; /* can be NULL to omit */
54 static HRESULT
register_interfaces(struct regsvr_interface
const *list
);
55 static HRESULT
unregister_interfaces(struct regsvr_interface
const *list
);
59 CLSID
const *clsid
; /* NULL for end of list */
60 LPCSTR name
; /* can be NULL to omit */
61 LPCSTR ips
; /* can be NULL to omit */
62 LPCSTR ips32
; /* can be NULL to omit */
63 LPCSTR ips32_tmodel
; /* can be NULL to omit */
65 LPCSTR clsid_str
; /* can be NULL to omit */
66 LPCSTR progid
; /* can be NULL to omit */
69 /* flags for regsvr_coclass.flags */
70 #define SHELLEX_MAYCHANGEDEFAULTMENU 0x00000001
72 static HRESULT
register_coclasses(struct regsvr_coclass
const *list
);
73 static HRESULT
unregister_coclasses(struct regsvr_coclass
const *list
);
75 /***********************************************************************
76 * static string constants
78 static WCHAR
const interface_keyname
[10] = {
79 'I', 'n', 't', 'e', 'r', 'f', 'a', 'c', 'e', 0 };
80 static WCHAR
const base_ifa_keyname
[14] = {
81 'B', 'a', 's', 'e', 'I', 'n', 't', 'e', 'r', 'f', 'a', 'c',
83 static WCHAR
const num_methods_keyname
[11] = {
84 'N', 'u', 'm', 'M', 'e', 't', 'h', 'o', 'd', 's', 0 };
85 static WCHAR
const ps_clsid_keyname
[15] = {
86 'P', 'r', 'o', 'x', 'y', 'S', 't', 'u', 'b', 'C', 'l', 's',
88 static WCHAR
const ps_clsid32_keyname
[17] = {
89 'P', 'r', 'o', 'x', 'y', 'S', 't', 'u', 'b', 'C', 'l', 's',
90 'i', 'd', '3', '2', 0 };
91 static WCHAR
const clsid_keyname
[6] = {
92 'C', 'L', 'S', 'I', 'D', 0 };
93 static WCHAR
const ips_keyname
[13] = {
94 'I', 'n', 'P', 'r', 'o', 'c', 'S', 'e', 'r', 'v', 'e', 'r',
96 static WCHAR
const ips32_keyname
[15] = {
97 'I', 'n', 'P', 'r', 'o', 'c', 'S', 'e', 'r', 'v', 'e', 'r',
99 static WCHAR
const progid_keyname
[7] = {
100 'P', 'r', 'o', 'g', 'I', 'D', 0 };
101 static WCHAR
const shellex_keyname
[8] = {
102 's', 'h', 'e', 'l', 'l', 'e', 'x', 0 };
103 static WCHAR
const mcdm_keyname
[21] = {
104 'M', 'a', 'y', 'C', 'h', 'a', 'n', 'g', 'e', 'D', 'e', 'f',
105 'a', 'u', 'l', 't', 'M', 'e', 'n', 'u', 0 };
106 static char const tmodel_valuename
[] = "ThreadingModel";
108 /***********************************************************************
109 * static helper functions
111 static LONG
register_key_guid(HKEY base
, WCHAR
const *name
, GUID
const *guid
);
112 static LONG
register_key_defvalueW(HKEY base
, WCHAR
const *name
,
114 static LONG
register_key_defvalueA(HKEY base
, WCHAR
const *name
,
116 static LONG
recursive_delete_key(HKEY key
);
117 static LONG
recursive_delete_keyA(HKEY base
, char const *name
);
118 static LONG
recursive_delete_keyW(HKEY base
, WCHAR
const *name
);
120 /***********************************************************************
121 * register_interfaces
123 static HRESULT
register_interfaces(struct regsvr_interface
const *list
)
125 LONG res
= ERROR_SUCCESS
;
128 res
= RegCreateKeyExW(HKEY_CLASSES_ROOT
, interface_keyname
, 0, NULL
, 0,
129 KEY_READ
| KEY_WRITE
, NULL
, &interface_key
, NULL
);
130 if (res
!= ERROR_SUCCESS
) goto error_return
;
132 for (; res
== ERROR_SUCCESS
&& list
->iid
; ++list
) {
136 StringFromGUID2(list
->iid
, buf
, 39);
137 res
= RegCreateKeyExW(interface_key
, buf
, 0, NULL
, 0,
138 KEY_READ
| KEY_WRITE
, NULL
, &iid_key
, NULL
);
139 if (res
!= ERROR_SUCCESS
) goto error_close_interface_key
;
142 res
= RegSetValueExA(iid_key
, NULL
, 0, REG_SZ
,
143 (CONST BYTE
*)(list
->name
),
144 strlen(list
->name
) + 1);
145 if (res
!= ERROR_SUCCESS
) goto error_close_iid_key
;
148 if (list
->base_iid
) {
149 register_key_guid(iid_key
, base_ifa_keyname
, list
->base_iid
);
150 if (res
!= ERROR_SUCCESS
) goto error_close_iid_key
;
153 if (0 <= list
->num_methods
) {
154 static WCHAR
const fmt
[3] = { '%', 'd', 0 };
157 res
= RegCreateKeyExW(iid_key
, num_methods_keyname
, 0, NULL
, 0,
158 KEY_READ
| KEY_WRITE
, NULL
, &key
, NULL
);
159 if (res
!= ERROR_SUCCESS
) goto error_close_iid_key
;
161 wsprintfW(buf
, fmt
, list
->num_methods
);
162 res
= RegSetValueExW(key
, NULL
, 0, REG_SZ
,
164 (lstrlenW(buf
) + 1) * sizeof(WCHAR
));
167 if (res
!= ERROR_SUCCESS
) goto error_close_iid_key
;
170 if (list
->ps_clsid
) {
171 register_key_guid(iid_key
, ps_clsid_keyname
, list
->ps_clsid
);
172 if (res
!= ERROR_SUCCESS
) goto error_close_iid_key
;
175 if (list
->ps_clsid32
) {
176 register_key_guid(iid_key
, ps_clsid32_keyname
, list
->ps_clsid32
);
177 if (res
!= ERROR_SUCCESS
) goto error_close_iid_key
;
181 RegCloseKey(iid_key
);
184 error_close_interface_key
:
185 RegCloseKey(interface_key
);
187 return res
!= ERROR_SUCCESS
? HRESULT_FROM_WIN32(res
) : S_OK
;
190 /***********************************************************************
191 * unregister_interfaces
193 static HRESULT
unregister_interfaces(struct regsvr_interface
const *list
)
195 LONG res
= ERROR_SUCCESS
;
198 res
= RegOpenKeyExW(HKEY_CLASSES_ROOT
, interface_keyname
, 0,
199 KEY_READ
| KEY_WRITE
, &interface_key
);
200 if (res
== ERROR_FILE_NOT_FOUND
) return S_OK
;
201 if (res
!= ERROR_SUCCESS
) goto error_return
;
203 for (; res
== ERROR_SUCCESS
&& list
->iid
; ++list
) {
206 StringFromGUID2(list
->iid
, buf
, 39);
207 res
= recursive_delete_keyW(interface_key
, buf
);
210 RegCloseKey(interface_key
);
212 return res
!= ERROR_SUCCESS
? HRESULT_FROM_WIN32(res
) : S_OK
;
215 /***********************************************************************
218 static HRESULT
register_coclasses(struct regsvr_coclass
const *list
)
220 LONG res
= ERROR_SUCCESS
;
223 res
= RegCreateKeyExW(HKEY_CLASSES_ROOT
, clsid_keyname
, 0, NULL
, 0,
224 KEY_READ
| KEY_WRITE
, NULL
, &coclass_key
, NULL
);
225 if (res
!= ERROR_SUCCESS
) goto error_return
;
227 for (; res
== ERROR_SUCCESS
&& list
->clsid
; ++list
) {
231 StringFromGUID2(list
->clsid
, buf
, 39);
232 res
= RegCreateKeyExW(coclass_key
, buf
, 0, NULL
, 0,
233 KEY_READ
| KEY_WRITE
, NULL
, &clsid_key
, NULL
);
234 if (res
!= ERROR_SUCCESS
) goto error_close_coclass_key
;
237 res
= RegSetValueExA(clsid_key
, NULL
, 0, REG_SZ
,
238 (CONST BYTE
*)(list
->name
),
239 strlen(list
->name
) + 1);
240 if (res
!= ERROR_SUCCESS
) goto error_close_clsid_key
;
244 res
= register_key_defvalueA(clsid_key
, ips_keyname
, list
->ips
);
245 if (res
!= ERROR_SUCCESS
) goto error_close_clsid_key
;
251 res
= RegCreateKeyExW(clsid_key
, ips32_keyname
, 0, NULL
, 0,
252 KEY_READ
| KEY_WRITE
, NULL
,
254 if (res
!= ERROR_SUCCESS
) goto error_close_clsid_key
;
256 res
= RegSetValueExA(ips32_key
, NULL
, 0, REG_SZ
,
257 (CONST BYTE
*)list
->ips32
,
258 lstrlenA(list
->ips32
) + 1);
259 if (res
== ERROR_SUCCESS
&& list
->ips32_tmodel
)
260 res
= RegSetValueExA(ips32_key
, tmodel_valuename
, 0, REG_SZ
,
261 (CONST BYTE
*)list
->ips32_tmodel
,
262 strlen(list
->ips32_tmodel
) + 1);
263 RegCloseKey(ips32_key
);
264 if (res
!= ERROR_SUCCESS
) goto error_close_clsid_key
;
267 if (list
->flags
& SHELLEX_MAYCHANGEDEFAULTMENU
) {
268 HKEY shellex_key
, mcdm_key
;
270 res
= RegCreateKeyExW(clsid_key
, shellex_keyname
, 0, NULL
, 0,
271 KEY_READ
| KEY_WRITE
, NULL
,
273 if (res
!= ERROR_SUCCESS
) goto error_close_clsid_key
;
274 res
= RegCreateKeyExW(shellex_key
, mcdm_keyname
, 0, NULL
, 0,
275 KEY_READ
| KEY_WRITE
, NULL
,
277 RegCloseKey(shellex_key
);
278 if (res
!= ERROR_SUCCESS
) goto error_close_clsid_key
;
279 RegCloseKey(mcdm_key
);
282 if (list
->clsid_str
) {
283 res
= register_key_defvalueA(clsid_key
, clsid_keyname
,
285 if (res
!= ERROR_SUCCESS
) goto error_close_clsid_key
;
291 res
= register_key_defvalueA(clsid_key
, progid_keyname
,
293 if (res
!= ERROR_SUCCESS
) goto error_close_clsid_key
;
295 res
= RegCreateKeyExA(HKEY_CLASSES_ROOT
, list
->progid
, 0,
296 NULL
, 0, KEY_READ
| KEY_WRITE
, NULL
,
298 if (res
!= ERROR_SUCCESS
) goto error_close_clsid_key
;
300 res
= register_key_defvalueW(progid_key
, clsid_keyname
, buf
);
301 RegCloseKey(progid_key
);
302 if (res
!= ERROR_SUCCESS
) goto error_close_clsid_key
;
305 error_close_clsid_key
:
306 RegCloseKey(clsid_key
);
309 error_close_coclass_key
:
310 RegCloseKey(coclass_key
);
312 return res
!= ERROR_SUCCESS
? HRESULT_FROM_WIN32(res
) : S_OK
;
315 /***********************************************************************
316 * unregister_coclasses
318 static HRESULT
unregister_coclasses(struct regsvr_coclass
const *list
)
320 LONG res
= ERROR_SUCCESS
;
323 res
= RegOpenKeyExW(HKEY_CLASSES_ROOT
, clsid_keyname
, 0,
324 KEY_READ
| KEY_WRITE
, &coclass_key
);
325 if (res
== ERROR_FILE_NOT_FOUND
) return S_OK
;
326 if (res
!= ERROR_SUCCESS
) goto error_return
;
328 for (; res
== ERROR_SUCCESS
&& list
->clsid
; ++list
) {
331 StringFromGUID2(list
->clsid
, buf
, 39);
332 res
= recursive_delete_keyW(coclass_key
, buf
);
333 if (res
!= ERROR_SUCCESS
) goto error_close_coclass_key
;
336 res
= recursive_delete_keyA(HKEY_CLASSES_ROOT
, list
->progid
);
337 if (res
!= ERROR_SUCCESS
) goto error_close_coclass_key
;
341 error_close_coclass_key
:
342 RegCloseKey(coclass_key
);
344 return res
!= ERROR_SUCCESS
? HRESULT_FROM_WIN32(res
) : S_OK
;
347 /***********************************************************************
350 static LONG
register_key_guid(HKEY base
, WCHAR
const *name
, GUID
const *guid
)
354 StringFromGUID2(guid
, buf
, 39);
355 return register_key_defvalueW(base
, name
, buf
);
358 /***********************************************************************
359 * regsvr_key_defvalueW
361 static LONG
register_key_defvalueW(
369 res
= RegCreateKeyExW(base
, name
, 0, NULL
, 0,
370 KEY_READ
| KEY_WRITE
, NULL
, &key
, NULL
);
371 if (res
!= ERROR_SUCCESS
) return res
;
372 res
= RegSetValueExW(key
, NULL
, 0, REG_SZ
, (CONST BYTE
*)value
,
373 (lstrlenW(value
) + 1) * sizeof(WCHAR
));
378 /***********************************************************************
379 * regsvr_key_defvalueA
381 static LONG
register_key_defvalueA(
389 res
= RegCreateKeyExW(base
, name
, 0, NULL
, 0,
390 KEY_READ
| KEY_WRITE
, NULL
, &key
, NULL
);
391 if (res
!= ERROR_SUCCESS
) return res
;
392 res
= RegSetValueExA(key
, NULL
, 0, REG_SZ
, (CONST BYTE
*)value
,
393 lstrlenA(value
) + 1);
398 /***********************************************************************
399 * recursive_delete_key
401 static LONG
recursive_delete_key(HKEY key
)
404 WCHAR subkey_name
[MAX_PATH
];
409 cName
= sizeof(subkey_name
) / sizeof(WCHAR
);
410 res
= RegEnumKeyExW(key
, 0, subkey_name
, &cName
,
411 NULL
, NULL
, NULL
, NULL
);
412 if (res
!= ERROR_SUCCESS
&& res
!= ERROR_MORE_DATA
) {
413 res
= ERROR_SUCCESS
; /* presumably we're done enumerating */
416 res
= RegOpenKeyExW(key
, subkey_name
, 0,
417 KEY_READ
| KEY_WRITE
, &subkey
);
418 if (res
== ERROR_FILE_NOT_FOUND
) continue;
419 if (res
!= ERROR_SUCCESS
) break;
421 res
= recursive_delete_key(subkey
);
423 if (res
!= ERROR_SUCCESS
) break;
426 if (res
== ERROR_SUCCESS
) res
= RegDeleteKeyW(key
, 0);
430 /***********************************************************************
431 * recursive_delete_keyA
433 static LONG
recursive_delete_keyA(HKEY base
, char const *name
)
438 res
= RegOpenKeyExA(base
, name
, 0, KEY_READ
| KEY_WRITE
, &key
);
439 if (res
== ERROR_FILE_NOT_FOUND
) return ERROR_SUCCESS
;
440 if (res
!= ERROR_SUCCESS
) return res
;
441 res
= recursive_delete_key(key
);
446 /***********************************************************************
447 * recursive_delete_keyW
449 static LONG
recursive_delete_keyW(HKEY base
, WCHAR
const *name
)
454 res
= RegOpenKeyExW(base
, name
, 0, KEY_READ
| KEY_WRITE
, &key
);
455 if (res
== ERROR_FILE_NOT_FOUND
) return ERROR_SUCCESS
;
456 if (res
!= ERROR_SUCCESS
) return res
;
457 res
= recursive_delete_key(key
);
462 /***********************************************************************
465 static GUID
const CLSID_Desktop
= {
466 0x00021400, 0x0000, 0x0000, {0xC0,0x00,0x00,0x00,0x00,0x00,0x00,0x46} };
468 static GUID
const CLSID_Shortcut
= {
469 0x00021401, 0x0000, 0x0000, {0xC0,0x00,0x00,0x00,0x00,0x00,0x00,0x46} };
471 static struct regsvr_coclass
const coclass_list
[] = {
483 SHELLEX_MAYCHANGEDEFAULTMENU
485 { NULL
} /* list terminator */
488 /***********************************************************************
492 static struct regsvr_interface
const interface_list
[] = {
493 { NULL
} /* list terminator */
496 /***********************************************************************
497 * DllRegisterServer (SHELL32.@)
499 HRESULT WINAPI
SHELL32_DllRegisterServer()
505 hr
= register_coclasses(coclass_list
);
507 hr
= register_interfaces(interface_list
);
511 /***********************************************************************
512 * DllUnregisterServer (SHELL32.@)
514 HRESULT WINAPI
SHELL32_DllUnregisterServer()
520 hr
= unregister_coclasses(coclass_list
);
522 hr
= unregister_interfaces(interface_list
);