e7b2d9ecfee015928723b1a6fa27711e63080717
[reactos.git] / reactos / lib / devmgr / stubs.c
1 /* $Id$
2 *
3 * COPYRIGHT: See COPYING in the top level directory
4 * PROJECT: ReactOS devmgr.dll
5 * FILE: lib/devmgr/stubs.c
6 * PURPOSE: devmgr.dll stubs
7 * PROGRAMMER: Thomas Weidenmueller (w3seek@users.sourceforge.net)
8 * NOTES: If you implement a function, remove it from this file
9 *
10 * Some helpful resources:
11 * http://support.microsoft.com/default.aspx?scid=kb;%5BLN%5D;815320
12 * http://www.jsiinc.com/SUBO/tip7400/rh7482.htm
13 * http://www.jsiinc.com/SUBM/tip6400/rh6490.htm
14 *
15 * UPDATE HISTORY:
16 * 04-04-2004 Created
17 */
18 #include <precomp.h>
19
20 #define NDEBUG
21 #include <debug.h>
22
23 /***************************************************************************
24 * NAME EXPORTED
25 * DeviceManager_ExecuteA
26 *
27 * DESCRIPTION
28 * Starts the Device Manager
29 *
30 * ARGUMENTS
31 * hWndParent: Handle to the parent window
32 * hInst: Handle to the application instance
33 * lpMachineName: Machine Name, NULL is the local machine
34 * nCmdShow: Specifies how the window should be shown
35 *
36 * RETURN VALUE
37 * TRUE: if no errors occured
38 * FALSE: if the device manager could not be executed
39 *
40 * REVISIONS
41 *
42 * NOTE
43 * - Win runs the device manager in a separate process, so hWndParent is somehow
44 * obsolete.
45 *
46 * @unimplemented
47 */
48 WINBOOL
49 WINAPI
50 DeviceManager_ExecuteA(HWND hWndParent,
51 HINSTANCE hInst,
52 LPCSTR lpMachineName,
53 int nCmdShow)
54 {
55 UNIMPLEMENTED;
56 return FALSE;
57 }
58
59
60 /***************************************************************************
61 * NAME EXPORTED
62 * DeviceManager_ExecuteW
63 *
64 * DESCRIPTION
65 * Starts the Device Manager
66 *
67 * ARGUMENTS
68 * hWndParent: Handle to the parent window
69 * hInst: Handle to the application instance
70 * lpMachineName: Machine Name, NULL is the local machine
71 * nCmdShow: Specifies how the window should be shown
72 *
73 * RETURN VALUE
74 * TRUE: if no errors occured
75 * FALSE: if the device manager could not be executed
76 *
77 * REVISIONS
78 *
79 * NOTE
80 * - Win runs the device manager in a separate process, so hWndParent is somehow
81 * obsolete.
82 *
83 * @unimplemented
84 */
85 WINBOOL
86 WINAPI
87 DeviceManager_ExecuteW(HWND hWndParent,
88 HINSTANCE hInst,
89 LPCWSTR lpMachineName,
90 int nCmdShow)
91 {
92 UNIMPLEMENTED;
93 return FALSE;
94 }
95
96
97 /***************************************************************************
98 * NAME EXPORTED
99 * DeviceProperties_RunDLLA
100 *
101 * DESCRIPTION
102 * Invokes the device properties dialog
103 *
104 * ARGUMENTS
105 * hWndParent: Handle to the parent window
106 * hInst: Handle to the application instance
107 * lpDeviceCmd: A command that includes the DeviceID of the properties to be shown,
108 * also see NOTEs
109 * nCmdShow: Specifies how the window should be shown
110 *
111 * RETURN VALUE
112 *
113 * REVISIONS
114 *
115 * NOTE
116 * - lpDeviceCmd is a string in the form of "/MachineName MACHINE /DeviceID DEVICEPATH"
117 * (/MachineName is optional). This function only parses this string and eventually
118 * calls DeviceProperties().
119 *
120 * @unimplemented
121 */
122 VOID
123 WINAPI
124 DeviceProperties_RunDLLA(HWND hWndParent,
125 HINSTANCE hInst,
126 LPCSTR lpDeviceCmd,
127 int nCmdShow)
128 {
129 UNIMPLEMENTED;
130 }
131
132
133 /***************************************************************************
134 * NAME EXPORTED
135 * DeviceProperties_RunDLLW
136 *
137 * DESCRIPTION
138 * Invokes the device properties dialog
139 *
140 * ARGUMENTS
141 * hWndParent: Handle to the parent window
142 * hInst: Handle to the application instance
143 * lpDeviceCmd: A command that includes the DeviceID of the properties to be shown,
144 * also see NOTEs
145 * nCmdShow: Specifies how the window should be shown
146 *
147 * RETURN VALUE
148 *
149 * REVISIONS
150 *
151 * NOTE
152 * - lpDeviceCmd is a string in the form of "/MachineName MACHINE /DeviceID DEVICEPATH"
153 * (/MachineName is optional). This function only parses this string and eventually
154 * calls DeviceProperties().
155 *
156 * @unimplemented
157 */
158 VOID
159 WINAPI
160 DeviceProperties_RunDLLW(HWND hWndParent,
161 HINSTANCE hInst,
162 LPCWSTR lpDeviceCmd,
163 int nCmdShow)
164 {
165 UNIMPLEMENTED;
166 }
167
168
169 /***************************************************************************
170 * NAME EXPORTED
171 * DevicePropertiesA
172 *
173 * DESCRIPTION
174 * Invokes the device properties dialog directly
175 *
176 * ARGUMENTS
177 * hWndParent: Handle to the parent window
178 * hInst: Handle to the application instance
179 * lpMachineName: Machine Name, NULL is the local machine
180 * lpDeviceID: Specifies the device whose properties are to be shown
181 * Unknown: Unknown parameter, see NOTEs
182 *
183 * RETURN VALUE
184 * >=0: if no errors occured
185 * -1: if errors occured
186 *
187 * REVISIONS
188 *
189 * NOTE
190 * Unknown seems to be a BOOL, not sure what it does
191 *
192 * @unimplemented
193 */
194 int
195 WINAPI
196 DevicePropertiesA(HWND hWndParent,
197 HINSTANCE hInst,
198 LPCSTR lpMachineName,
199 LPCSTR lpDeviceID,
200 DWORD Unknown)
201 {
202 UNIMPLEMENTED;
203 return -1;
204 }
205
206
207 /***************************************************************************
208 * NAME EXPORTED
209 * DevicePropertiesW
210 *
211 * DESCRIPTION
212 * Invokes the device properties dialog directly
213 *
214 * ARGUMENTS
215 * hWndParent: Handle to the parent window
216 * hInst: Handle to the application instance
217 * lpMachineName: Machine Name, NULL is the local machine
218 * lpDeviceID: Specifies the device whose properties are to be shown
219 * Unknown: Unknown parameter, see NOTEs
220 *
221 * RETURN VALUE
222 * >=0: if no errors occured
223 * -1: if errors occured
224 *
225 * REVISIONS
226 *
227 * NOTE
228 * Unknown seems to be a BOOL, not sure what it does
229 *
230 * @unimplemented
231 */
232 int
233 WINAPI
234 DevicePropertiesW(HWND hWndParent,
235 HINSTANCE hInst,
236 LPCWSTR lpMachineName,
237 LPCWSTR lpDeviceID,
238 DWORD Unknown)
239 {
240 UNIMPLEMENTED;
241 return -1;
242 }
243
244
245 /***************************************************************************
246 * NAME EXPORTED
247 * DeviceProblemWizard_RunDLLA
248 *
249 * DESCRIPTION
250 * Calls the device problem wizard
251 *
252 * ARGUMENTS
253 * hWndParent: Handle to the parent window
254 * hInst: Handle to the application instance
255 * lpDeviceCmd: A command that includes the DeviceID of the properties to be shown,
256 * also see NOTEs
257 * nCmdShow: Specifies how the window should be shown
258 *
259 * RETURN VALUE
260 *
261 * REVISIONS
262 *
263 * NOTE
264 * - Win XP exports this function as DeviceProblenWizard_RunDLLA, apparently it's
265 * a typo so we additionally export an alias function
266 * - lpDeviceCmd is a string in the form of "/MachineName MACHINE /DeviceID DEVICEPATH"
267 * (/MachineName is optional). This function only parses this string and eventually
268 * calls DeviceProperties().
269 *
270 * @unimplemented
271 */
272 VOID
273 WINAPI
274 DeviceProblemWizard_RunDLLA(HWND hWndParent,
275 HINSTANCE hInst,
276 LPCSTR lpDeviceCmd,
277 int nCmdShow)
278 {
279 UNIMPLEMENTED;
280 }
281
282
283 /***************************************************************************
284 * NAME EXPORTED
285 * DeviceProblemWizard_RunDLLW
286 *
287 * DESCRIPTION
288 * Calls the device problem wizard
289 *
290 * ARGUMENTS
291 * hWndParent: Handle to the parent window
292 * hInst: Handle to the application instance
293 * lpDeviceCmd: A command that includes the DeviceID of the properties to be shown,
294 * also see NOTEs
295 * nCmdShow: Specifies how the window should be shown
296 *
297 * RETURN VALUE
298 *
299 * REVISIONS
300 *
301 * NOTE
302 * - Win XP exports this function as DeviceProblenWizard_RunDLLA, apparently it's
303 * a typo so we additionally export an alias function
304 * - lpDeviceCmd is a string in the form of "/MachineName MACHINE /DeviceID DEVICEPATH"
305 * (/MachineName is optional). This function only parses this string and eventually
306 * calls DeviceProperties().
307 *
308 * @unimplemented
309 */
310 VOID
311 WINAPI
312 DeviceProblemWizard_RunDLLW(HWND hWndParent,
313 HINSTANCE hInst,
314 LPCWSTR lpDeviceCmd,
315 int nCmdShow)
316 {
317 UNIMPLEMENTED;
318 }
319
320
321 /***************************************************************************
322 * NAME EXPORTED
323 * DeviceManagerPrintA
324 *
325 * DESCRIPTION
326 * Calls the device problem wizard
327 *
328 * ARGUMENTS
329 * lpMachineName: Machine Name, NULL is the local machine
330 * lpPrinter: Filename of the printer where it should be printed on
331 * nPrintMode: Specifies what kind of information is to be printed
332 * DEV_PRINT_ABSTRACT: Prints an abstract of system information, the parameters
333 * uNumberOfGuids, Guids are ignored
334 * DEV_PRINT_SELECTED: Prints information about the devices listed in Guids
335 * DEV_PRINT_ALL: Prints an abstract of system information and all
336 * system devices
337 * uNumberOfGuids: Numbers of guids in the Guids array, this parameter is ignored unless
338 * nPrintMode is DEV_PRINT_SELECTED
339 * lpGuids: Array of device guids, this parameter is ignored unless
340 * nPrintMode is DEV_PRINT_SELECTED
341 *
342 * RETURN VALUE
343 * TRUE: if no errors occured
344 * FALSE: if errors occured
345 *
346 * REVISIONS
347 *
348 * NOTE
349 *
350 * @unimplemented
351 */
352 WINBOOL
353 WINAPI
354 DeviceManagerPrintA(LPCSTR lpMachineName,
355 LPCSTR lpPrinter,
356 int nPrintMode,
357 UINT uNumberOfGuids,
358 LPGUID lpGuids)
359 {
360 UNIMPLEMENTED;
361 return FALSE;
362 }
363
364
365 /***************************************************************************
366 * NAME EXPORTED
367 * DeviceManagerPrintW
368 *
369 * DESCRIPTION
370 * Calls the device problem wizard
371 *
372 * ARGUMENTS
373 * lpMachineName: Machine Name, NULL is the local machine
374 * lpPrinter: Filename of the printer where it should be printed on
375 * nPrintMode: Specifies what kind of information is to be printed
376 * DEV_PRINT_ABSTRACT: Prints an abstract of system information, the parameters
377 * uNumberOfGuids, Guids are ignored
378 * DEV_PRINT_SELECTED: Prints information about the devices listed in Guids
379 * DEV_PRINT_ALL: Prints an abstract of system information and all
380 * system devices
381 * uNumberOfGuids: Numbers of guids in the Guids array, this parameter is ignored unless
382 * nPrintMode is DEV_PRINT_SELECTED
383 * lpGuids: Array of device guids, this parameter is ignored unless
384 * nPrintMode is DEV_PRINT_SELECTED
385 *
386 * RETURN VALUE
387 * TRUE: if no errors occured
388 * FALSE: if errors occured
389 *
390 * REVISIONS
391 *
392 * NOTE
393 *
394 * @unimplemented
395 */
396 WINBOOL
397 WINAPI
398 DeviceManagerPrintW(LPCWSTR lpMachineName,
399 LPCWSTR lpPrinter,
400 int nPrintMode,
401 UINT uNumberOfGuids,
402 LPGUID lpGuids)
403 {
404 UNIMPLEMENTED;
405 return FALSE;
406 }