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