(for Internet Explorer)
← ▼ ▲
↑
SetEOS (ADODB.Stream)
(Web)
Sub Stream::SetEOS()
ストリームの中の現在位置以後のデータを削除します。
Position プロパティ
で現在位置を戻したときに使います。
← ▼ ▲
Position (ADODB.Stream)
(Web)
Property Stream::Position as integer
現在位置。 リードまたはライトするバイト位置。
先頭は 0 です。
ファイルの末尾(Position=Size-1)の次(Position=Size)より後に
Position を設定しようとするとエラーになります。
Mode = adModeReadWrite でもエラーになります。
← ▼ ▲
Size (ADODB.Stream)
Property Stream::Size as integer
ストリーム・バッファーのサイズ（バイト）
(Web)
← ▼ ▲
CopyTo (ADODB.Stream)
Sub Stream::CopyTo( DstStream as Stream , Size as integer )
ストリームの一部を、別のストリームへコピーします。
← ▼ ▲
WScript.Network
WSH から使えるネットワークに関するライブラリです。
← ▼ ▲
EnumNetworkDrives (WScript.Network)
(Web)
Function Network::EnumNetworkDrives() as IWshCollection
ネットワーク・ドライブと、そのリンク先を一覧します。
【引数】
返り値
ネットワーク・ドライブと、そのリンク先の一覧
Dim i
Dim net : Set net = WScript.CreateObject("WScript.Network")
Dim drives : Set drives = net.EnumNetworkDrives()
For i = 0 to drives.Count - 1 Step 2
echo drives(i) +" = "+ drives(i+1)
Next
サンプル
出力例：
H: = \\pc01\home
N: = \\pc01\export
← ▼ ▲
レジストリ
Set g_sh = WScript.CreateObject("WScript.Shell")
WScript.Echo g_sh.RegRead( "HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\"+_
"Explorer\Shell Folders\My Pictures" )
g_sh.RegWrite "HKEY_CURRENT_USER\Software\_Test\Sample", "Value1", "REG_SZ"
WScript.Echo g_sh.RegRead( "HKEY_CURRENT_USER\Software\_Test\Sample" )
g_sh.RegDelete "HKEY_CURRENT_USER\Software\_Test\Sample"
g_sh.RegDelete "HKEY_CURRENT_USER\Software\_Test\" '// キーを削除するときは末尾に \
サンプル：
レジストリのパスが間違っていると、80070002 エラーになります。
レジストリに読み書きできます。
RegRead
RegWrite
RegRead
RegWrite
RegDelete
RegDelete
StdRegProv
WScript.Shell クラス
StdRegProv クラス
アクセス権が無かったときは、下記のエラーになります。
[ERROR](0x80070005) レジストリ キー "HKEY_CLASSES_ROOT\.lbk\" のルートが無効です
[ERROR](70) 書き込みできません
vbslib
RegWrite
レジストリ
RegEnumKey
→ レジストリ (vbslib)
関連
← ▼ ▲
WMI (Windows Management Instrumentation)
→ WMI スクリプト入門 第 1 部 (Web)
Windows NT 4.0 Service Pack 4 以降
Distributed Management Task Force (DMTF) が監視する業界標準に基づいている。
スクリプトを使って OS の管理機能にアクセスする。（WIN32 API を使わない）
物理メモリサイズ、プロセス管理、サービス、共有、ネットワーク管理など
→ GetOSVersion (vbslib)
参考
→ StdRegProv
レジストリを操作するクラスです。
(Web)
← ▼ ▲
StdRegProv
(Web)
レジストリを操作するクラスです。
[ 親: WMI ]
→ EnumKey Method of the StdRegProv Class (Windows) (Web)
.EnumKey
→ EnumValues Method of the StdRegProv Class (Windows) (Web)
.EnumValues
（他にもあります）
Sub RegEnumKey( Path, out_Keys )
Dim reg, i, root_key
i = InStr( Path, "\" )
Select Case Left( Path, i - 1 )
Case "HKEY_CLASSES_ROOT" : root_key = &h80000000
Case "HKEY_CURRENT_USER" : root_key = &h80000001
Case "HKEY_LOCAL_MACHINE" : root_key = &h80000002
Case "HKEY_USERS" : root_key = &h80000003
Case "HKEY_PERFORMANCE_DATA":root_key= &h80000004
Case "HKEY_CURRENT_CONFIG": root_key = &h80000005
Case "HKEY_DYN_DATA" : root_key = &h80000006
Case Else : Err.Raise &h80070002
End Select
Path = Mid( Path, i + 1 )
Set reg = GetObject("winmgmts:{impersonationLevel=impersonate}!root/default:StdRegProv")
reg.enumkey root_key, Path, out_Keys
End Sub
サンプル
レジストリの Path のキーのサブキーの名前を out_Keys 配列に列挙します。
サブキーが無いときは out_Keys = Null になります。
→ DeleteValue Method of the StdRegProv Class (Windows) (Web)
.DeleteValue
← ▼ ▲
Win32_TimeZone
(Web)
サンプル
Assert get_WMI( Empty, "Win32_TimeZone" ).Bias = 540 '// TZD = +09:00 = 9*60 = 540
TZD = タイムゾーン, TimeZoneDesignator
← ▼ ▲
自動化のヒント
→ ログ
→ ステータス・ファイル、*_current ファイル
→ ユーザーインターフェイス・構造体
→ 環境変数クラス
← ▼ ▲
ログ
セクションの進捗具合をログに出力すると良いでしょう。
← ▼ ▲
自動化すると、途中で失敗したときに、また最初から行わなければならないことがあります。
それを避けるため、復元ポイントに到達したことを記録していきます。
処理を続きから実行するかどうかについては、
ステータス・ファイル、*_current.xml ファイル
<CurrentXxx>
<Specification name="(changing)" from="Base" to="New">
<EnvVars current="New" from="Old" to="New"/>
<Regs current="Old" from="Old" to="New"/>
</Specification>
</CurrentXxx>
関連
→ SAU問題 (Set After Use)
→ ロールバック
<CurrentXxx>
<Specification name="Base">
<EnvVars current="New"/>
<Regs current="New"/>
</Specification>
</CurrentXxx>
定常状態のステータス・ファイル
コミット・ファイル と 代理更新ファイル
Makefile や
活性化状態のステータス・ファイル
MakeRule クラス(vbslib)
を使うと、複雑な依存関係も対処できるでしょう。
を活用して
→ MakeFileClass (vbslib)
← ▼ ▲
ロールバック
ロールバックとは、時間のかかる処理の途中にある復元ポイントから次の復元ポイントまで実行
する途中でエラーが発生したときに、前の復元ポイントの状態にデータやファイルを戻すことです。
次の復元ポイントまで行う処理を、一時フォルダの中で実行すれば、その一時フォルダを削除する
だけで、復元ポイントまで戻ることができます。
次の復元ポイントまで行う処理によって変更されるファイルの範囲に対して、バックアップを取れば、
リストアするだけで、復元ポイントまで戻ることができます。
復元ポイント１
復元ポイント２
一時フォルダ
バックアップ
エラーが発生したところでプログラムは異常終了させます。 次に起動したときに、一時フォルダや
バックアップの存在などから、復元ポイントの途中であることを検出して、ロールバックしてから、
再度復元ポイントから処理を開始させます。
→ コミット・ファイル と 代理更新ファイル
関連
ロールバック処理は、通常の処理の前に常に行ってください。
→ ステータス・ファイル、*_current.xml ファイル
場合によっては、通常のロールバック処理より大きな単位のロールバック処理が必要になること
があります（たとえば、リビルド）。 大きな単位のロールバック処理を実現する手段は、MakeFile
で指定したターゲットファイルの一部、またはすべてを削除することなどがあります。
→ MakeFileClass (vbslib)
← ▼ ▲
ユーザーインターフェイス・構造体
GUI でも CUI でも、ユーザーが入力したデータをすべて１つの構造体にまとめます。
階層化やインターフェイスを使って、領域を分割します。
メンバ変数名の先頭に m_ を付けるなどのルールがあれば、検索しやすくなります。
まとめると、現在の設定値を再利用して、差分の入力を自由にカスタマイズできます。
ユーザー入力を自動化すると、差分入力の仕様の変更に弱くなるので、自動化するときは、
構造体にパラメータを指定します。
← ▼ ▲
環境変数クラス
環境変数はグローバルなので扱いにくい場合もあります。
そこで環境変数を VBS のクラスのメンバ変数に入れて、各種自動処理を行います。
← ▼ ▲
処理速度
← ▼ ▲
引数に配列を渡す速度
Sub main2( Opt, AppKey )
Dim t0, t1, arr
ReDim arr( 10000000 )
t0 = Timer
CallWithArray arr
t1 = Timer - t0
WScript.Echo FormatNumber( t1, 3 ) & "(sec)" '// 0.000(sec)
t0 = Timer
CallWithByValArray arr
t1 = Timer - t0
WScript.Echo FormatNumber( t1, 3 ) & "(sec)" '// 0.753(sec)
t0 = Timer
LetArray arr
t1 = Timer - t0
WScript.Echo FormatNumber( t1, 3 ) & "(sec)" '// 0.783(sec)
End Sub
Sub CallWithArray( arr )
End Sub
Sub CallWithByValArray( ByVal arr )
End Sub
Sub LetArray( arr )
Dim b : b = arr
End Sub
配列を渡すとき、ByVal を付けるとコピーが発生して遅くなります。
ByVal が無ければ、一瞬で渡ります。
→ 関数の引数に、単体と配列のどちらでも指定できるようにする
関連
← ▼ ▲
配列要素を追加する速度
ReDim Preserve arr( UBound( arr ) + 1 )
arr( UBound( arr ) ) = 1234
上記のように、１要素ずつ増やすと、処理速度はかなり遅くなります。
Sub T_AddToFastUBound_Speed( Opt, AppKey )
Dim t0, t1, arr, arrc, i, arr_fast_ubound, plus
Const n = 100000
'//=== pre ReDim
ReDim arr(-1)
t0 = Timer
ReDim Preserve arr( n )
For i=0 To n
arr( i ) = i
Next
t1 = Timer - t0
WScript.Echo FormatNumber( t1, 3 ) & "(sec)" '// 0.031(sec)
Assert UBound( arr ) = n
For i=0 To n : Assert arr( i ) = i : Next
'//=== ReDim each add
ReDim arr(-1)
t0 = Timer
For i=0 To n
ReDim Preserve arr( UBound( arr ) + 1 )
arr( UBound( arr ) ) = i
Next
t1 = Timer - t0
WScript.Echo FormatNumber( t1, 3 ) & "(sec)" '// 0.688(sec)
Assert UBound( arr ) = n
For i=0 To n : Assert arr( i ) = i : Next
'//=== arr_fast_ubound : +1
ReDim arr(-1)
arr_fast_ubound = UBound( arr )
t0 = Timer
For i=0 To n
If UBound(arr) <= arr_fast_ubound Then _
ReDim Preserve arr( ( arr_fast_ubound + 100 ) * 4 )
arr_fast_ubound = arr_fast_ubound + 1
arr( arr_fast_ubound ) = i
Next
ReDim Preserve arr( arr_fast_ubound )
t1 = Timer - t0
WScript.Echo FormatNumber( t1, 3 ) & "(sec)" '// 0.125(sec)
Assert UBound( arr ) = n
For i=0 To n : Assert arr( i ) = i : Next
'//=== arr_fast_ubound : +plus
ReDim arr(-1)
arr_fast_ubound = UBound( arr )
plus = +1
t0 = Timer
For i=0 To n
If UBound(arr) < arr_fast_ubound + plus Then _
ReDim Preserve arr( ( arr_fast_ubound + plus + 100 ) * 4 )
arr_fast_ubound = arr_fast_ubound + plus
arr( arr_fast_ubound ) = i
Next
ReDim Preserve arr( arr_fast_ubound )
t1 = Timer - t0
WScript.Echo FormatNumber( t1, 3 ) & "(sec)" '// 0.172(sec)
Assert UBound( arr ) = n
For i=0 To n : Assert arr( i ) = i : Next
'//=== arr_fast_ubound : Big and reduce (*2)
ReDim arr(-1)
t0 = Timer
ReDim Preserve arr( 100000*2 )
For i=0 To n
arr( i ) = i
Next
ReDim Preserve arr( n )
t1 = Timer - t0
WScript.Echo FormatNumber( t1, 3 ) & "(sec)" '// 0.031(sec)
Assert UBound( arr ) = n
For i=0 To n : Assert arr( i ) = i : Next
'//=== arr_fast_ubound : Big and reduce (*15)
ReDim arr(-1)
t0 = Timer
ReDim Preserve arr( 100000*15 )
For i=0 To n
arr( i ) = i
Next
ReDim Preserve arr( n )
t1 = Timer - t0
WScript.Echo FormatNumber( t1, 3 ) & "(sec)" '// 0.125(sec)
Assert UBound( arr ) = n
For i=0 To n : Assert arr( i ) = i : Next
'//=== ArrayClassFastUBound
Set arrc = new ArrayClassFastUBound
arrc.StartFastUBound
t0 = Timer
For i=0 To n
arrc.AddToFastUBound i
Next
arrc.EndFastUBound
t1 = Timer - t0
WScript.Echo FormatNumber( t1, 3 ) & "(sec)" '// 0.766(sec)
Assert UBound( arrc.Items ) = n
For i=0 To n : Assert arrc.Items( i ) = i : Next
End Sub
→ T_Arr.vbs # [T_AddToFastUBound_Speed]
arr_fast_ubound
← ▼ ▲
ファイルを一覧するときの速度
File オブジェクト
Folder オブジェクト
や
の Path プロパティや Name プロパティは、
処理速度が遅いです。
← ▼ ▲
エラー、デバッグ (VBScript)
→ エラー処理, On Error
→ デバッグ用ファイル出力
→ 動作ログ
→ WScript.Echo
→ デバッガ （Visual Studio などに統合された機能）
printf デバッグ
→ Err オブジェクト
→ エラーコード、エラーメッセージ、トラブルシューティング
→ エラーを発生させる
→ ステップ実行デバッグ
→ Finally ブロック
→ （Err版）
→ サブ・プロシージャと On Error の動き
→ イミディエイトウィンドウ （実行してみる）
→ ブレークポイント
→ ウォッチ （変数の値をチェックする）
← ▼ ▲
デバッガ （Visual Studio などに統合された機能）
cscript //x script.vbs
デバッグを中止するときは、スクリプトを実行しているコマンドプロンプトを
終了します。(cscript 使用時のみ可能） wscript のプロセスを終了させるには、
タスクマネージャーを使うか、コマンドプロンプトから次のように入力します。
taskkill /IM "wscript.exe" /F
途中で止めたいときは、ブレークポイントを張るか、Stop 命令をスクリプト中に記述
します。
起動コマンド：
WSH のデバッガーをインストールしてから、次のように //x を付けて起動すると、
デバッガが起動し、スクリプトの先頭で止まります。
→ Visual Studio (有料)
→ MS Office 2000, XP, 2003 (有料)
→ Windows Script Debugger (msscrdbg.exe, scd10jp.exe) (無料)
→ VbsEdit (Web) (有料)
バッチファイルやショートカットにするとよいでしょう。
デバッガーの画面：
WSH のデバッガー
関連
→ vbslib 版 - コマンドラインやショートカットからデバッガーに接続する
← ▼ ▲
Visual Studio (有料)
インストールすると、自動的に使えるようになります。
確認済み： 2005, 2008, 2010 の Standard, Professional 以上。
Express Edition は、WSH をデバッグできません。 （VC++, VB, VC#, WebDev）
[ デバッグ > ウィンドウ > イミディエイト ] を選ぶと、? に続けて式を入力すると、実行して
結果を表示できます。
エラーが発生したりブレークしたら、[ デバッグ > ウィンドウ > 呼び出し履歴 ] から、関数の
呼び出し関係を確認できます。
エラーが発生したりブレークしたら、変数を右クリック、または、式を選択して右クリック
[ ウォッチ式の追加 ] を選ぶと、値を確認できます。
JIT のリストから 「新しいインスタンス Visual Studio xxxx」 を表示させないようにするには、
Visual Studio [ ツール > オプション > デバッグ > Just-In-Time ] の [ スクリプト ] のチェックを
はずします。
[ 親: WSH のデバッガー ]
→ クライアント側スクリプトのデバッグ (Web)
参考
Visual Studio のソリューション・エクスプローラーのソリューションを右クリック [ 名前の
変更 ] で名前の先頭に a をつけると、Just In Time Debugger のリストの先頭に表示され
ます。 もし、「ソリューション名を変更できません」 エラーが出るときは、
C:\WINDOWS\system32\*.suo を削除してください。
デバッガーを選択するときのリストの先頭にデバッガーを移動する
← ▼ ▲
MS Office 2000, XP, 2003 (有料)
フルインストールすると、自動的に、Microsoft Script Editor がインストールされます。
メニューの [ ツール(T) > マクロ(M) > Microsoft Script Editor(E) ] でもインストールが始まります。
JIT のリストから 「新しいインスタンス Microsoft Script Editor」 を表示させないようにするには、
Excel [ ツール > マクロ > Microsoft Script Editor > ツール > オプション > デバッグ > JIT の設定
> JIT デバッグを有効にする ] のチェックをはずします。
MS Office 2007, 2010 には、WSH のデバッガーは入っていません。
[ 親: WSH のデバッガー ]
← ▼ ▲
Windows Script Debugger (msscrdbg.exe, scd10jp.exe) (無料)
→ ダウンロード詳細 Windows Script Debugger (Web)
[ スタート > すぺてのプログラム > アクセサリ > コマンド プロンプト ] から、下記のように
入力します。
"C:\Program Files\Microsoft Script Debugger\msscrdbg.exe" /regserver
"C:\Program Files\Microsoft Script Debugger\msscrdbg.exe" /unregserver
?Err.Description
型が一致しません。
アンインストールするには、コマンド プロンプトに下記コマンドを入力してから、
エラーが発生したら、[ 表示 > コマンドウィンドウ ] から、次のように入力すると、エラーメッセージを
確認できます。
Windows XP の場合：
Windows 7 / 8(RP) の場合：
上記から、scd10jp.exe をダウンロードする。
Windows 8(RP) では、安全ではないと表示されますが、問題ありません。
ダウンロード・フォルダーなどにできたものを使ってください。
1.
2.
scd10jp.exe を右クリック [ 管理者として実行 ]。 インストール先は、デフォルトのまま。
再起動はしなくても構いません。
3.
スタート [ プログラムとファイルの検索 ] に [ regedit ] と入力して
（Windows 8(RP) では、スタート画面を表示させて、キーボードから [ regedit ] と入力して）
[ Enter ] キーを押し、
[HKEY_CLASSES_ROOT\CLSID\{834128A2-51F4-11D0-8F20-00805F2CD064}\LocalServer32]
の （既定） に、C:\Program Files\Microsoft Script Debugger\msscrdbg.exe を入力する。
scd10jp.exe をダブルクリック。 インストール先は、デフォルトのまま。
再起動はしなくても構いません。
2.
1.
上記から、scd10jp.exe をダウンロードする。
3.
GetEchoStr 関数 (要vbslib) を使うと、オブジェクトの型や、配列の要素を確認できます。
?GetEchoStr( object )
? に続けて変数名や、ピリオドに続けてプロパティ名を入力すると、値を確認できます。
?a
2
?object.prop
2
エラーが発生したりブレークしたら、[ 表示 > 呼び出し履歴 ] から、関数の呼び出し関係を確認でき
ます。
[ 親: WSH のデバッガー ]
コントロールパネルから、Microsoft Script Debugger をアンインストールする。
スクリプトの中の、途中で止めたい場所に、Stop 命令を記述して、
[ スタート > すぺてのプログラム > アクセサリ > コマンド プロンプト ] から、
デバッグを中止するときは、スクリプトを実行しているコマンドプロンプトを終了します。(cscript 使用
時のみ可能） wscript のプロセスを終了させるには、タスクマネージャーを使うか、コマンド
プロンプトから次のように入力します。 taskkill /IM "wscript.exe" /F
のように入力すると、デバッガーに接続します。 実行を開始すると、Stop 命令で止まります。
cscript //x script.vbs
デバッガーの使い方：
アンインストールするには、regedit を起動して、
[HKEY_CLASSES_ROOT\CLSID\{834128A2-51F4-11D0-8F20-00805F2CD064}\LocalServer32]
の（既定） に、C:\Windows\system32\mdm.exe を入力してから、
コントロールパネルから、Microsoft Script Debugger をアンインストールする。
←
↓