reactos/dll/win32/devmgr/stubs.c

   1 /*
   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 BOOL
  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 BOOL
  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  *      DeviceProblemWizard_RunDLLA
 100  *
 101  * DESCRIPTION
 102  *   Calls the device problem wizard
 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  *   - Win XP exports this function as DeviceProblenWizard_RunDLLA, apparently it's
 117  *     a typo so we additionally export an alias function
 118  *   - lpDeviceCmd is a string in the form of "/MachineName MACHINE /DeviceID DEVICEPATH"
 119  *     (/MachineName is optional). This function only parses this string and eventually
 120  *     calls DeviceProperties().
 121  *
 122  * @unimplemented
 123  */
 124 VOID
 125 WINAPI
 126 DeviceProblemWizard_RunDLLA(HWND hWndParent,
 127                             HINSTANCE hInst,
 128                             LPCSTR lpDeviceCmd,
 129                             int nCmdShow)
 130 {
 131   UNIMPLEMENTED;
 132 }
 133
 134
 135 /***************************************************************************
 136  * NAME                                                         EXPORTED
 137  *      DeviceProblemWizard_RunDLLW
 138  *
 139  * DESCRIPTION
 140  *   Calls the device problem wizard
 141  *
 142  * ARGUMENTS
 143  *   hWndParent:  Handle to the parent window
 144  *   hInst:       Handle to the application instance
 145  *   lpDeviceCmd: A command that includes the DeviceID of the properties to be shown,
 146  *                also see NOTEs
 147  *   nCmdShow:    Specifies how the window should be shown
 148  *
 149  * RETURN VALUE
 150  *
 151  * REVISIONS
 152  *
 153  * NOTE
 154  *   - Win XP exports this function as DeviceProblenWizard_RunDLLA, apparently it's
 155  *     a typo so we additionally export an alias function
 156  *   - lpDeviceCmd is a string in the form of "/MachineName MACHINE /DeviceID DEVICEPATH"
 157  *     (/MachineName is optional). This function only parses this string and eventually
 158  *     calls DeviceProperties().
 159  *
 160  * @unimplemented
 161  */
 162 VOID
 163 WINAPI
 164 DeviceProblemWizard_RunDLLW(HWND hWndParent,
 165                             HINSTANCE hInst,
 166                             LPCWSTR lpDeviceCmd,
 167                             int nCmdShow)
 168 {
 169   UNIMPLEMENTED;
 170 }
 171
 172
 173 /***************************************************************************
 174  * NAME                                                         EXPORTED
 175  *      DeviceManagerPrintA
 176  *
 177  * DESCRIPTION
 178  *   Calls the device problem wizard
 179  *
 180  * ARGUMENTS
 181  *   lpMachineName:  Machine Name, NULL is the local machine
 182  *   lpPrinter:      Filename of the printer where it should be printed on
 183  *   nPrintMode:     Specifies what kind of information is to be printed
 184  *                     DEV_PRINT_ABSTRACT: Prints an abstract of system information, the parameters
 185  *                                         uNumberOfGuids, Guids are ignored
 186  *                     DEV_PRINT_SELECTED: Prints information about the devices listed in Guids
 187  *                     DEV_PRINT_ALL:      Prints an abstract of system information and all
 188  *                                         system devices
 189  *   uNumberOfGuids: Numbers of guids in the Guids array, this parameter is ignored unless
 190  *                   nPrintMode is DEV_PRINT_SELECTED
 191  *   lpGuids:        Array of device guids, this parameter is ignored unless
 192  *                   nPrintMode is DEV_PRINT_SELECTED
 193  *
 194  * RETURN VALUE
 195  *   TRUE:  if no errors occured
 196  *   FALSE: if errors occured
 197  *
 198  * REVISIONS
 199  *
 200  * NOTE
 201  *
 202  * @unimplemented
 203  */
 204 BOOL
 205 WINAPI
 206 DeviceManagerPrintA(LPCSTR lpMachineName,
 207                     LPCSTR lpPrinter,
 208                     int nPrintMode,
 209                     UINT uNumberOfGuids,
 210                     LPGUID lpGuids)
 211 {
 212   UNIMPLEMENTED;
 213   return FALSE;
 214 }
 215
 216
 217 /***************************************************************************
 218  * NAME                                                         EXPORTED
 219  *      DeviceManagerPrintW
 220  *
 221  * DESCRIPTION
 222  *   Calls the device problem wizard
 223  *
 224  * ARGUMENTS
 225  *   lpMachineName:  Machine Name, NULL is the local machine
 226  *   lpPrinter:      Filename of the printer where it should be printed on
 227  *   nPrintMode:     Specifies what kind of information is to be printed
 228  *                     DEV_PRINT_ABSTRACT: Prints an abstract of system information, the parameters
 229  *                                         uNumberOfGuids, Guids are ignored
 230  *                     DEV_PRINT_SELECTED: Prints information about the devices listed in Guids
 231  *                     DEV_PRINT_ALL:      Prints an abstract of system information and all
 232  *                                         system devices
 233  *   uNumberOfGuids: Numbers of guids in the Guids array, this parameter is ignored unless
 234  *                   nPrintMode is DEV_PRINT_SELECTED
 235  *   lpGuids:        Array of device guids, this parameter is ignored unless
 236  *                   nPrintMode is DEV_PRINT_SELECTED
 237  *
 238  * RETURN VALUE
 239  *   TRUE:  if no errors occured
 240  *   FALSE: if errors occured
 241  *
 242  * REVISIONS
 243  *
 244  * NOTE
 245  *
 246  * @unimplemented
 247  */
 248 BOOL
 249 WINAPI
 250 DeviceManagerPrintW(LPCWSTR lpMachineName,
 251                     LPCWSTR lpPrinter,
 252                     int nPrintMode,
 253                     UINT uNumberOfGuids,
 254                     LPGUID lpGuids)
 255 {
 256   UNIMPLEMENTED;
 257   return FALSE;
 258 }