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