Edit

DeviceProperties_RunDLL Function Prototype

  • Article

The DeviceProperties_RunDLL function opens the device properties dialog box for a specified device that is installed on a local or remote computer.

void DeviceProperties_RunDLL(
  HWND       hwndStub,
  HINSTANCE  hAppInstance,
  LPCTSTR    lpCmdLine,
  int        nCmdShow
  );

Parameters

hwndStub
A handle to the window in which to display the user interface items that DeviceProperties_RunDLL creates.

hAppInstance
This parameter is not used to invoke a device properties dialog box and should be set to NULL.

lpCmdLine
A pointer to a constant NULL-terminated command-line string that contains a machine-name-parameter field followed by a device-instance-ID-parameter field in the following format:

machine-name-parameter device-instance-ID-parameter

machine-name-parameter
The machine-name-parameter field supplies the name of the machine that is associated with the device that is specified by the device-instance-ID-parameter field. The format of the machine-name-parameter field is /MachineName **** machine-name, where /MachineName indicates that machine-name supplies a computer name. For more information about the machine-name-parameter field, see the Remarks section.

device-instance-ID-parameter
The device-instance-ID-parameter field supplies a device instance identifier of the device for which to display a device properties dialog box. The format of device-instance-ID-parameter field is /DeviceId **** device-instance-ID, where /DeviceId indicates that device-instance-ID supplies a device instance identifier. The device-instance-ID-parameter field is required.

nCmdShow
This parameter is not used to invoke a device properties dialog box and should be set to NULL.

Return Value

None

Headers

DeviceProperties_RunDLL is not declared in a public header and can only be invoked indirectly by programmatically obtaining a pointer to the function or by using rundll32.

Remarks

On Windows XP, the machine-name-parameter field is required only for a remote computer, and, if the machine-name-parameter field is not supplied, the local computer is used by default. On Windows 2000, the machine-name-parameter field is required for a local computer or a remote computer. To specify a local computer, set machine-name in the machine-name-parameter field to a pair of quotation marks (""). If the machine is a remote computer, set machine-name to a valid computer name. A valid computer name must include a prefix that consists of a pair of backslashes(\) followed by the machine name.

The following are examples of command-line strings:

  • (Windows XP and later) Specifying the local computer is optional, in which case the command-line string is required to include only the device instance identifier. For example, the following command-line specifies the local computer by default and the device instance identifier "root\system\0000".

    /DeviceId root\system\0000

  • (Windows 2000 and later) The following command-line string supplies the remote computer name "\\RemoteMachineAbc" and the device instance identifier "root\system\0000".

    /MachineName \\RemoteMachineAbc /DeviceId root\system\0000

  • (Windows 2000 and later) The following command-line string specifies a local computer, which is specified by a pair of quotation marks (""), and supplies the device instance identifier "root\system\0000".

    /MachineName "" /DeviceId root\system\0000