DeviceProperties_RunDLL 函数原型

  • 项目

DeviceProperties_RunDLL 函数将打开本地或远程计算机上安装的指定设备的设备属性对话框。

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

参数

hwndStub
窗口的句柄，其中显示DeviceProperties_RunDLL创建的用户界面项。

hAppInstance
此参数不用于调用设备属性对话框，应设置为 NULL。

lpCmdLine
指向以 NULL 结尾的常量命令行字符串的指针，该字符串包含一个 machine-name-parameter 字段，后跟采用以下格式的 device-instance-ID-parameter 字段：

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

machine-name-parameter
machine-name-parameter 字段提供与 device-instance-ID-parameter 字段指定的设备关联的计算机的名称。 machine-name-parameter 字段的格式为 /MachineName **** machine-name，其中 /MachineName 指示 machine-name 提供计算机名称。 有关 machine-name-parameter 字段的详细信息，请参阅备注部分。

device-instance-ID-parameter
device-instance-ID-parameter 字段提供要显示设备属性对话框的设备的设备实例标识符。 device-instance-ID-parameter 字段的格式为 /DeviceId **** device-instance-ID，其中 /DeviceId 指示 device-instance-ID 提供设备实例标识符。 device-instance-ID-parameter 字段是必需的。

nCmdShow
此参数不用于调用设备属性对话框，应设置为 NULL。

返回值

无

头文件

DeviceProperties_RunDLL未在公共标头中声明，只能通过以编程方式获取指向函数的指针或使用 rundll32 间接调用。

注释

在 Windows XP 上，仅远程计算机需要 machine-name-parameter 字段，如果未提供 machine-name-parameter 字段，则默认使用本地计算机。 在 Windows 2000 上，本地计算机或远程计算机需要 计算机名称参数 字段。 若要指定本地计算机，请将 machine-name-parameter 字段中的 machine-name 设置为一对引号 (“”) 。 如果计算机是远程计算机，请将 计算机名称 设置为有效的计算机名称。 有效的计算机名称必须包含前缀，该前缀由一对反斜杠 (\) 后跟计算机名称组成。

下面是命令行字符串的示例：

  • (Windows XP 及更高版本) 指定本地计算机是可选的，在这种情况下，需要命令行字符串来仅包含设备实例标识符。 例如，以下命令行默认指定本地计算机和设备实例标识符“root\system\0000”。

    /DeviceId root\system\0000

  • (Windows 2000 及更高版本) 以下命令行字符串提供远程计算机名称“\\RemoteMachineAbc”和设备实例标识符“root\system\0000”。

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

  • (Windows 2000 及更高版本) 以下命令行字符串指定本地计算机，该计算机由一对引号 (“”) 指定，并提供设备实例标识符“root\system\0000”。

    /MachineName "" /DeviceId root\system\0000