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
  19 #include <windef.h>
  20
  21 #define NDEBUG
  22 #include <debug.h>
  23
  24 /***************************************************************************
  25  * NAME                                                         EXPORTED
  26  *      DeviceManager_ExecuteA
  27  *
  28  * DESCRIPTION
  29  *   Starts the Device Manager
  30  *
  31  * ARGUMENTS
  32  *   hWndParent:   Handle to the parent window
  33  *   hInst:        Handle to the application instance
  34  *   lpMachineName: Machine Name, NULL is the local machine
  35  *   nCmdShow:      Specifies how the window should be shown
  36  *
  37  * RETURN VALUE
  38  *   TRUE:  if no errors occured
  39  *   FALSE: if the device manager could not be executed
  40  *
  41  * REVISIONS
  42  *
  43  * NOTE
  44  *   - Win runs the device manager in a separate process, so hWndParent is somehow
  45  *     obsolete.
  46  *
  47  * @unimplemented
  48  */
  49 BOOL
  50 WINAPI
  51 DeviceManager_ExecuteA(HWND hWndParent,
  52                        HINSTANCE hInst,
  53                        LPCSTR lpMachineName,
  54                        int nCmdShow)
  55 {
  56   UNIMPLEMENTED;
  57   return FALSE;
  58 }
  59
  60
  61 /***************************************************************************
  62  * NAME                                                         EXPORTED
  63  *      DeviceManager_ExecuteW
  64  *
  65  * DESCRIPTION
  66  *   Starts the Device Manager
  67  *
  68  * ARGUMENTS
  69  *   hWndParent:   Handle to the parent window
  70  *   hInst:        Handle to the application instance
  71  *   lpMachineName: Machine Name, NULL is the local machine
  72  *   nCmdShow:      Specifies how the window should be shown
  73  *
  74  * RETURN VALUE
  75  *   TRUE:  if no errors occured
  76  *   FALSE: if the device manager could not be executed
  77  *
  78  * REVISIONS
  79  *
  80  * NOTE
  81  *   - Win runs the device manager in a separate process, so hWndParent is somehow
  82  *     obsolete.
  83  *
  84  * @unimplemented
  85  */
  86 BOOL
  87 WINAPI
  88 DeviceManager_ExecuteW(HWND hWndParent,
  89                        HINSTANCE hInst,
  90                        LPCWSTR lpMachineName,
  91                        int nCmdShow)
  92 {
  93   UNIMPLEMENTED;
  94   return FALSE;
  95 }
  96
  97
  98 /***************************************************************************
  99  * NAME                                                         EXPORTED
 100  *      DeviceProblemWizard_RunDLLA
 101  *
 102  * DESCRIPTION
 103  *   Calls the device problem wizard
 104  *
 105  * ARGUMENTS
 106  *   hWndParent:  Handle to the parent window
 107  *   hInst:       Handle to the application instance
 108  *   lpDeviceCmd: A command that includes the DeviceID of the properties to be shown,
 109  *                also see NOTEs
 110  *   nCmdShow:    Specifies how the window should be shown
 111  *
 112  * RETURN VALUE
 113  *
 114  * REVISIONS
 115  *
 116  * NOTE
 117  *   - Win XP exports this function as DeviceProblenWizard_RunDLLA, apparently it's
 118  *     a typo so we additionally export an alias function
 119  *   - lpDeviceCmd is a string in the form of "/MachineName MACHINE /DeviceID DEVICEPATH"
 120  *     (/MachineName is optional). This function only parses this string and eventually
 121  *     calls DeviceProperties().
 122  *
 123  * @unimplemented
 124  */
 125 VOID
 126 WINAPI
 127 DeviceProblemWizard_RunDLLA(HWND hWndParent,
 128                             HINSTANCE hInst,
 129                             LPCSTR lpDeviceCmd,
 130                             int nCmdShow)
 131 {
 132   UNIMPLEMENTED;
 133 }
 134
 135
 136 /***************************************************************************
 137  * NAME                                                         EXPORTED
 138  *      DeviceProblemWizard_RunDLLW
 139  *
 140  * DESCRIPTION
 141  *   Calls the device problem wizard
 142  *
 143  * ARGUMENTS
 144  *   hWndParent:  Handle to the parent window
 145  *   hInst:       Handle to the application instance
 146  *   lpDeviceCmd: A command that includes the DeviceID of the properties to be shown,
 147  *                also see NOTEs
 148  *   nCmdShow:    Specifies how the window should be shown
 149  *
 150  * RETURN VALUE
 151  *
 152  * REVISIONS
 153  *
 154  * NOTE
 155  *   - Win XP exports this function as DeviceProblenWizard_RunDLLA, apparently it's
 156  *     a typo so we additionally export an alias function
 157  *   - lpDeviceCmd is a string in the form of "/MachineName MACHINE /DeviceID DEVICEPATH"
 158  *     (/MachineName is optional). This function only parses this string and eventually
 159  *     calls DeviceProperties().
 160  *
 161  * @unimplemented
 162  */
 163 VOID
 164 WINAPI
 165 DeviceProblemWizard_RunDLLW(HWND hWndParent,
 166                             HINSTANCE hInst,
 167                             LPCWSTR lpDeviceCmd,
 168                             int nCmdShow)
 169 {
 170   UNIMPLEMENTED;
 171 }
 172
 173
 174 /***************************************************************************
 175  * NAME                                                         EXPORTED
 176  *      DeviceManagerPrintA
 177  *
 178  * DESCRIPTION
 179  *   Calls the device problem wizard
 180  *
 181  * ARGUMENTS
 182  *   lpMachineName:  Machine Name, NULL is the local machine
 183  *   lpPrinter:      Filename of the printer where it should be printed on
 184  *   nPrintMode:     Specifies what kind of information is to be printed
 185  *                     DEV_PRINT_ABSTRACT: Prints an abstract of system information, the parameters
 186  *                                         uNumberOfGuids, Guids are ignored
 187  *                     DEV_PRINT_SELECTED: Prints information about the devices listed in Guids
 188  *                     DEV_PRINT_ALL:      Prints an abstract of system information and all
 189  *                                         system devices
 190  *   uNumberOfGuids: Numbers of guids in the Guids array, this parameter is ignored unless
 191  *                   nPrintMode is DEV_PRINT_SELECTED
 192  *   lpGuids:        Array of device guids, this parameter is ignored unless
 193  *                   nPrintMode is DEV_PRINT_SELECTED
 194  *
 195  * RETURN VALUE
 196  *   TRUE:  if no errors occured
 197  *   FALSE: if errors occured
 198  *
 199  * REVISIONS
 200  *
 201  * NOTE
 202  *
 203  * @unimplemented
 204  */
 205 BOOL
 206 WINAPI
 207 DeviceManagerPrintA(LPCSTR lpMachineName,
 208                     LPCSTR lpPrinter,
 209                     int nPrintMode,
 210                     UINT uNumberOfGuids,
 211                     LPGUID lpGuids)
 212 {
 213   UNIMPLEMENTED;
 214   return FALSE;
 215 }
 216
 217
 218 /***************************************************************************
 219  * NAME                                                         EXPORTED
 220  *      DeviceManagerPrintW
 221  *
 222  * DESCRIPTION
 223  *   Calls the device problem wizard
 224  *
 225  * ARGUMENTS
 226  *   lpMachineName:  Machine Name, NULL is the local machine
 227  *   lpPrinter:      Filename of the printer where it should be printed on
 228  *   nPrintMode:     Specifies what kind of information is to be printed
 229  *                     DEV_PRINT_ABSTRACT: Prints an abstract of system information, the parameters
 230  *                                         uNumberOfGuids, Guids are ignored
 231  *                     DEV_PRINT_SELECTED: Prints information about the devices listed in Guids
 232  *                     DEV_PRINT_ALL:      Prints an abstract of system information and all
 233  *                                         system devices
 234  *   uNumberOfGuids: Numbers of guids in the Guids array, this parameter is ignored unless
 235  *                   nPrintMode is DEV_PRINT_SELECTED
 236  *   lpGuids:        Array of device guids, this parameter is ignored unless
 237  *                   nPrintMode is DEV_PRINT_SELECTED
 238  *
 239  * RETURN VALUE
 240  *   TRUE:  if no errors occured
 241  *   FALSE: if errors occured
 242  *
 243  * REVISIONS
 244  *
 245  * NOTE
 246  *
 247  * @unimplemented
 248  */
 249 BOOL
 250 WINAPI
 251 DeviceManagerPrintW(LPCWSTR lpMachineName,
 252                     LPCWSTR lpPrinter,
 253                     int nPrintMode,
 254                     UINT uNumberOfGuids,
 255                     LPGUID lpGuids)
 256 {
 257   UNIMPLEMENTED;
 258   return FALSE;
 259 }