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                          LPCWSTR 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                          LPCSTR 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 }