WshShell 对象.doc

WshShell 对象ProgID Wscript.Shell 文件名 WSHom.Ocx CLSID F935DC22-1CF0-11d0-ADB9-00C04FD58A0B IID F935DC21-1CF0-11d0-ADB9-00C04FD58A0B下表说明和 WshShell 对象有关的属性。属性 说明 Environment 返回 WshEnvironment 集合对象。 SpecialFolders 使用 WshSpecialFolders 对象提供对 Windows shell 文件夹的访问，如桌面文件夹，开始菜单文件夹和个人文档文件夹。下表说明和 WshShell 对象有关的方法。方法 说明 CreateShortcut 创建并返回 WshShortcut 对象。 ExpandEnvironmentStrings 扩展 PROCESS 环境变量并返回结果字符串。 Popup 显示包含指定消息的消息窗口。 RegDelete 从注册表中删除指定的键或值。 RegRead 从注册表中返回指定的键或值。 RegWrite 在注册表中设置指定的键或值。 Run 创建新的进程，该进程用指定的窗口样式执行指定的命令。WshShell.EnvironmentEnvironment 属性返回 WshEnvironment 对象。 语法WshShell.Environment ( strType) = objWshEnvironment注释若 strType 指定了环境变量所处的位置，可能值为 System、User、Volatile 和 Process。若未提供 strType，则该方法在 Windows NT 中检索系统环境变量或在 Windows 95 中检索进程环境变量。对于 Windows 95，strType 参数仅支持 Process。下列变量是由 Windows 操作系统提供的。脚本也可获取由其他应用程序设置的环境变量。名称 说明 NUMBER_OF_PROCESSORS 计算机上运行的处理器数目。 PROCESSOR_ARCHITECTURE 用户工作站使用的处理器类型。 PROCESSOR_IDENTIFIER 用户工作站的处理器 ID。 PROCESSOR_LEVEL 用户工作站的处理器级。 PROCESSOR_REVISION 用户工作站的处理器版本。 OS 用户工作站所用的操作系统。 COMSPEC 用于运行“命令提示”窗口的命令（通常为 cmd.exe）。 HOMEDRIVE 本地主驱动器（通常为 C 驱动器）。 HOMEPATH 用户的默认路径（在 Windows NT 上通常为 usersdefault）。 PATH 路径环境变量。 PATHEXT 可执行文件的扩展名（通常为 .com、 .exe、.bat 或 .cmd）。 PROMPT 命令提示符（通常为 PG）。 SYSTEMDRIVE 系统所在的本地驱动器（例如，c:）。 SYSTEMROOT 系统目录（例如，c:winnt）。和 WINDIR 相同。 WINDIR 系统目录（例如 c:winnt）。和 SYSTEMROOT 相同。 TEMP 存储临时文件的目录（例如，c:temp）。用户可更改。 TMP 存储临时文件的目录（例如，c:temp）。用户可更改。示例 Retrieve the NUMBER_OF_PROCESSORS system environment variableSet WshShell = Wscript.CreateObject(Wscript.Shell)Set WshSysEnv = WshShell.Environment(SYSTEM)Wscript.Echo WshSysEnv(NUMBER_OF_PROCESSORS)请参阅WshEnvironment 对象WshEnvironment 对象WshEnvironment 对象未直接给出，可用 WshShell.Environment 属性来访问。ProgID N/A 文件名 WSHom.Ocx CLSID IID下表描述与 WshEnvironment 对象关联的属性。属性 说明 Item 获取或设置指定的环境变量值。 Count 枚举项的数目。 length 枚举项的数目 (JScript)。下表描述与 WshEnvironment 对象关联的方法。 方法 说明 Remove 删除指定的环境变量。WshShell.SpecialFoldersSpecialFolders 属性提供 WshSpecialFolders 对象以便访问 Windows 的 shell 文件夹，例如桌面文件夹、开始菜单文件夹和个人文档文件夹。语法WshShell.SpecialFolders = objWshSpecialFolders示例 This code fragment shows how to access the desktop folderSet WshShell = Wscript.CreateObject(Wscript.Shell)MsgBox Your desktop is & WshShell.SpecialFolders(Desktop)请参阅WshSpecialFolders 对象WshSpecialFolders 对象该对象未直接给出。要得到 WshSpecialFolders 对象，请使用 WshShell.SpecialFolders 属性。ProgID N/A 文件名 WSHom.Ocx CLSID IID下表描述与 WshSpecialFolders 对象关联的属性。 属性 描述 Item 指定文件夹的完整路径（默认）。 Count 枚举项的数目。 length 枚举项的数目 (JScript) 。 WshSpecialFolders.ItemItem 属性返回由 strFolderName 指定的文件夹的完整路径。它是默认属性。语法WshShell.SpecialFolders.Item(strFolderName) = strFolderPathWshShell.SpecialFolders(strFolderName) = strFolderPath注释若请求的文件夹 (strFolderName) 不可用，则 WshShell.SpecialFolders(strFolderName) 返回 NULL。例如，Windows 95 没有 AllUsersDesktop 文件夹，如果 strFolderName = AllUsersDesktop，则返回 NULL。Windows 95 和 Windows NT 4.0 操作系统提供下列指定文件夹： AllUsersDesktopAllUsersStartMenuAllUsersProgramsAllUsersStartupDesktopFavoritesFontsMyDocumentsNetHoodPrintHoodProgramsRecentSendToStartMenuStartupTemplates示例 This fragment returns the full path for the Windows Desktop folderSet WshShell = Wscript.CreateObject(Wscript.Shell)StrMyDesktop = WshShell.SpecialFolders(Desktop) List all special foldersFor Each strFolder In WshShell.SpecialFoldersMsgBox strFolderNext请参阅WshShell.SpecialFolders 属性WshShell.CreateShortcutCreateShortcut 方法创建 WshShortcut 对象并将其返回。如果快捷方式标题以 .url 结尾，就会创建 WshURLShortcut 对象。语法WshShell.CreateShortcut(strPathname) = objShortcut示例 This code fragment creates a shortcut to the currently executing scriptSet WshShell = Wscript.CreateObject(Wscript.Shell)Set oShellLink = WshShell.CreateShortcut(Current Script.lnk)oShellLink.TargetPath = Wscript.ScriptFullNameoShellLink.SaveSet oUrlLink = WshShell.CreateShortcut(Microsoft Web Site.URL)oUrlLink.TargetPath = oUrlLink.Save请参阅WshShortcut 对象、WshUrlShortcut 对象WshShortcut 对象该对象未直接给出。要获得 WshShortcut 对象，请使用 WshShell.CreateShortcut 方法。ProgID N/A 文件名 WSHom.Ocx CLSID F935DC28-1CF0-11d0-ADB9-00C04FD58A0B IID F935DC27-1CF0-11d0-ADB9-00C04FD58A0B下表说明和 WshShortcut 对象有关的属性。属性 说明 Arguments 快捷方式对象的参数。 Description 快捷方式对象的说明。 Hotkey 快捷方式对象的热键。 IconLocation 快捷方式对象的图标位置。 TargetPath 快捷方式对象的目标路径。 WindowStyle 快捷方式对象的窗口样式。 WorkingDirectory 快捷方式对象的工作目录。下表说明与 WshShortcut 对象有关的方法。方法 说明 Save 将快捷方式存储到指定的文件系统中。 WshShortcut.ArgumentsArguments 属性提供快捷方式对象的参数。语法WshShortcut.Arguments = strArgumentsWshShortcut.DescriptionDescription 属性提供快捷方式对象的说明。语法WshShortcut.Description = strDescriptionWshShortcut.HotkeyHotKey 属性提供快捷方式对象的热键。热键是启动或切换程序的键盘快捷方式。语法WshShortcut.HotKey = strHotKey注释strHotKey 的BNF语法如下：Hotkey := modifier* keynamemodifier := ALT+ | CTRL+ | SHIFT+ | EXT+keyname := A . Z | 0. 9 | Back | Tab | Clear | Return |Escape | Space | Prior | .所有键的名称都可以在 WINUSER.H 中找到。热键不区分大小写。热键只能激活位于 Windows 桌面或 Windows“开始”菜单的快捷方式。Windows 资源管理器不接受 ESC、ENTER、TAB、SPACE、PRINT SCREEN 或 BACKSPACE，即使 WshShortcut.Hotkey 遵循 Win32 API 支持它们。因此，建议在快捷方式中不要用这些键。示例Set WshShell = Wscript.CreateObject(Wscript.WshShell)strDesktop = WshShell.SpecialFolders(Desktop)Set oMyShortcut = WshShell.CreateShortcut(strDesktop & a_key.lnk)OMyShortcut.TargetPath = %windir%notepad.exeoMyShortCut.Hotkey = ALT+CTRL+FoMyShortCut.SaveWscript.Echo oMyShortCut.HotKey = Alt+Ctrl+F请参阅WshSpecialFolders 对象WshShortcut.IconLocationIconLocation 属性提供快捷方式对象的图标位置。图标位置的格式应为 Path,index。语法WshShortcut.IconLocation = strIconLocationWshShortcut.TargetPathTargetPath 属性提供快捷方式对象的目标路径。语法WshShortcut.TargetPath = strTargetPathWshShortcut.WindowStyleWindowStyle 属性提供快捷方式对象的窗口样式。语法WshShortcut.WindowStyle = natWindowStyleWshShortcut.WorkingDirectoryWorkingDirectory 为一个快捷方式对象提供工作目录。语法WshShortcut.WorkingDirectory = strWorkingDirectoryWshShortcut.SaveSave 方法把快捷方式对象保存到由 FullName 属性指定的位置。语法WshShortcut.SaveWshUrlShortcut 对象该对象未直接给出。要获取 WshUrlShortcut 对象，可使用 WshShell.CreateShortcut 方法。ProgID N/A 文件名 WSHom.Ocx CLSID IID 下表说明了和 WshUrlShortcut 对象有关的属性。属性 说明 FullName URL 快捷方式对象的完整路径。 TargetPath URL 快捷方式对象的目标路径。下表说明了和 WshUrlShortcut 对象有关的方法。方法 说明 Save 将快捷方式保存到指定的文件系统中。 WshUrlShortcut.FullNameFullName 属性提供快捷方式对象的完整路径。语法WshUrlShortcut.FullName = strFullNameWshUrlShortcut.TargetPathTargetPath 属性提供快捷方式对象的目标路径。语法WshUrlShortcut.TargetPath = strTargetPathWshUrlShortcut.SaveSave 方法保存一个快捷方式，该快捷方式指向 FullName 属性指定的位置。语法WshUrlShortcut.SaveWshShell.ExpandEnvironmentStringsExpandEnvironmentStrings 方法在 strString 中扩展 PROCESS 环境变量并返回结果字符串。变量被 % 字符括起。环境变量不区分大小写。语法WshShell.ExpandEnvironmentStrings(strString) = strExpandedString示例MsgBox Prompt is & WshShell.ExpandEnviromentStrings(%PROMPT%)WshShell.PopupPopup 方法显示一个弹出式消息框窗口，消息框中包含的消息由 strText 指定。该消息框的窗口标题由 strTitle 指定。若 strTitle 省略，则窗口标题为 Windows Scripting Host。语法WshShell.Popup(strText, natSecondsToWait, strTitle, natType) = intButton注释若提供 natSecondsToWait 且其值大于零，则消息框在 natSecondsToWait 秒后关闭。natType 的含义与其在 Win32? MessageBox 函数中相同。下表显示 natType 中的值及含义。下表中的值可以组合。按钮类型值 说明 0 显示“确定”按钮 1 显示“确定”和“取消”按钮 2 显示“终止”、“重试”和“忽略”按钮 3 显示“是”、“否”和“取消”按钮 4 显示“是”和“否”按钮 5 显示“重试”和“取消”按钮图标类型值 说明 16 显示停止标记图标 32 显示问号图标 48 显示感叹号图标 64 显示信息标记图标以上两个表并不涵盖 natType 的所有值。完整的列表请参阅 Win32 文档。返回值 intButton 指示用户所单击的按扭编号。若用户在 natSecondsToWait 秒之前不单击按扭，则 intButton 设置为 -1 。值 说明 1 “确定”按扭 2 “取消”按扭 3 “终止”按扭 4 “重试”按扭 5 “忽略”按扭 6 “是”按扭 7 “否”按扭示例Set WshShell = Wscript.CreateObject(Wscript.Shell)WshShell.Popup Where do you want to go today?请参阅Wscript.Echo 方法Wscript.EchoEcho 方法在窗口（Wscript.exe 中）或“命令提示符”窗口（Cscript.exe 中）显示参数。参数用空格分隔。在 Cscript.exe 中，该方法在显示最后一个参数之后输出一对回车/换行（CR LF）。语法Wscript.Echo anyArg.示例 Wscript.EchoWscript.Echo 1, 2, 3Wscript.Echo Windows Scripting Host is cool.WshShell.RegDeleteRegDelete 从注册表中删除名为 strName 的键或值。 语法WshShell.RegDelete strName参数strName 如果 strName 以反斜杠 () 结束，则该方法删除键而不是值。 strName 参数必须以下列之一的根键名开始：短根键名 长根键名 HKCU HKEY_CURRENT_USER HKLM HKEY_LOCAL_MACHINE HKCR HKEY_CLASSES_ROOT HKEY_USERS HKEY_CURRENT_CONFIG示例Set WshShell = Wscript.CreateObject(Wscript.Shell)WshShell.RegDelete HKCUScriptEngineValue Delete value ValueWshShell.RegDelete HKCUScriptEngineKey Delete key Key请参阅WshShell.RegRead 方法、WshShell.RegWrite 方法WshShell.RegReadRegRead 方法返回名为 strName 的注册表键或值。 语法WshShell.RegRead(strName) = strValue参数strName 如果 strName 以反斜杠 () 结束，则该方法返回键，而不是值。strName 参数必须以下列根键名开始。Short Long HKCU HKEY_CURRENT_USER HKLM HKEY_LOCAL_MACHINE HKCR HKEY_CLASSES_ROOT HKEY_USERS HKEY_CURRENT_CONFIG注释RegRead 方法仅支持 REG_SZ、REG_EXPAND_SZ、REG_DWORD、REG_BINARY 和 REG_MULTI_SZ 数据类型。若注册表有其他数据类型，RegRead 返回 DISP_E_TYPEMISMATCH。示例Set WshShell = Wscript.CreateObject(Wscript.Shell)WshShell.RegRead(HKCUScriptEngineVal) Read from value ValWshShell.RegRead(HKCUScriptEngineKey) Read from key Key请参阅WshShell.RegDelete 方法、WshShell.RegWrite 方法WshShell.RegWriteRegWrite 方法设置名为 strName 的注册表键或值。 语法WshShell.RegWrite strName, anyValue, strType参数strName 若 strName 以一个反斜杠 () 结束，则该方法设置键，而不是值。strName 参数必须以下列根键名开头。Short Long HKCU HKEY_CURRENT_USER HKLM HKEY_LOCAL_MACHINE HKCR HKEY_CLASSES_ROOT HKEY_USERS HKEY_CURRENT_CONFIGanyValue 当 strType 为 REG_SZ 或 REG_EXPAND_SZ 时，RegWrite 方法自动将 anyValue 转换为字符串。若 strType 为 REG_DWORD，则 anyValue 被转换为整数。若 strType 为 REG_BINARY，则 anyValue 必须是一个整数。strType RegWrite 方法支持 strType 为 REG_SZ、REG_EXPAND_SZ、REG_DWORD 和 REG_BINARY。若其他的数据类型被作为 strType 传递，RegWrite 返回 E_INVALIDARG。 示例Set WshShell = Wscript.CreateObject(Wscript.Shell)WshShell.RegWrite HKCUScriptEngineValue, Some string valueWshShell.RegWrite HKCUScriptEngineKey, 1 REG_DWORD请参阅WshShell.RegDelete 方法、WshShell.RegWrite方法WshShell.RunRun 方法创建一个新的进程，该进程以 intWindowStyle 窗口样式执行 strCommand。语法WshShell.Run (strCommand, intWindowStyle, blnWaitOnReturn)参数strCommand 在 s