VBAの64bit問題と文字コード——古いマクロが動かない時の定番対処
年明けはPC入れ替えと環境更新の季節だ。そして毎年この時期に増える相談が「昔から使っているCATIAマクロが新しいPCで動かない」。原因は九分九厘、2つに絞られる。VBAの64bit問題と文字コード問題だ。現場で使い続けている定番の対処を、コード付きでまとめる。
Photo: Unsplash「動かないマクロ」の正体は2つしかない
新年の環境更新後に持ち込まれる不動マクロを開くと、原因はほぼ2種類に集約される。1つはコンパイルエラーで即死するタイプ。これはWindows APIを呼ぶDeclare文が64bit VBAに対応していないケースだ。もう1つは動くが出力が化けるタイプで、これはファイル入出力の文字コードが原因だ。
どちらも書いた本人が悪いわけではない。10年前の32bit環境では正しいコードだった。環境が変わり、コードが取り残されただけだ。逆に言えば、原因の型が決まっているので、対処も型で覚えられる。
この記事では2つの型それぞれについて、症状の見分け方と修正パターンを示す。修正自体は1本あたり数分で終わることが多い。怖がって塩漬けにするのが一番もったいない。
64bit問題——Declare文にPtrSafeを
コンパイルエラー型の症状は分かりやすい。マクロを開いた瞬間、Declare文が赤くなり「PtrSafe属性を付ける必要があります」という趣旨のエラーが出る。64bit版のVBA7では、外部API宣言にPtrSafeキーワードが必須になり、ハンドルやポインタを受ける変数はLongではなくLongPtrで宣言する必要がある。
修正の定番は条件付きコンパイルだ。#If VBA7で分岐を書けば、同じソースが旧32bit環境でも新64bit環境でも通る。移行期に両環境が混在する現場では、この書き分けが事実上の必須になる。全面的に64bitへ移行済みなら、PtrSafe付きに一本化してしまえばいい。
注意点はLongPtrの使い所だ。何でもLongPtrにすればいいわけではない。ウィンドウハンドルやポインタはLongPtr、単なる数値の引数はLongのまま。API仕様を確認せず機械的に置換すると、64bitでだけ落ちる不具合を新たに仕込むことになる。
環境が変わり、
コードが取り残されただけだ。
文字コード問題——CSVが化ける理由
出力化け型の症状は、CSVやテキストの日本語が読めない記号列になる、あるいは他システムから受け取ったUTF-8のファイルをマクロが正しく読めない、という形で現れる。VBAの古典的なOpenステートメントやFileSystemObjectの既定は日本語環境ではShift_JIS系であり、UTF-8の世界と噛み合っていない。
近年は連携先のシステムがUTF-8を要求する場面が急増した。設計データの受け渡し先がWebベースのシステムになり、BOM付きUTF-8でなければ取り込めない、といった要件が普通に来る。マクロ側だけShift_JISのままでは、環境が新しくなるほど化ける機会が増える。
対処の定番はADODB.Streamだ。文字セットを明示してファイルを読み書きできるため、Shift_JISとUTF-8を意図して使い分けられる。既定に任せず、入出力のたびに文字コードを宣言する。これだけで化ける事故は消える。
移行チェックの手順
手持ちのマクロ資産を新環境へ移すときの点検項目を整理しておく。まずDeclare文の有無を全ファイルで検索する。Declareを含むマクロだけがコンパイルエラー候補だ。次にOpenステートメントとFileSystemObjectの使用箇所を洗い、入出力の文字コードが明示されているかを見る。
忘れがちなのが参照設定とActiveXコントロールだ。32bit時代のOCXや古いライブラリへの参照は64bit環境に存在しないことがある。参照設定のエラーはコンパイルエラーの顔をして現れるので、Declare文と混同しやすい。エラーの原因がコードか参照かを最初に切り分けると早い。
点検は騒ぎが起きる前の平時にやるのが一番安い。数百本の資産があっても、検索と分類だけなら数時間で終わる。動かなくなってから業務を止めて直すのと、どちらが安いかは言うまでもない。
移行を機に、資産の棚卸しと配布を見直す
64bit対応の作業をしていると、必ず気づくことがある。直す価値のないマクロが山ほどあることだ。作者が退職し、用途も分からず、ただコピーされ続けてきたファイル。移行はこれを捨てる絶好の機会だ。全部直そうとせず、使われているものだけ直す。作らない勇気は、直さない勇気でもある。
直したマクロをメール添付で再配布したら、また同じことの繰り返しになる。せっかく手を入れるなら、サーバー1か所に正本を置く配布の仕組みとセットで移行することを勧めたい。環境更新は、散らかった資産を仕組みに載せ替える数年に一度の好機だ。
私たちも顧客環境の世代交代のたびに、この棚卸しと載せ替えを支援してきた。動かないという悲鳴から始まった作業が、資産一覧と配布基盤が整って終わる。転んでもただでは起きない移行にしてほしい。
手元の作業がこの方法で楽になりそうか、判断が付かないときは相談してください。効果が出そうか出なさそうかを、着手前に金額で見立てるところまでお手伝いします。
' 条件付きコンパイルで新旧環境の両方を通す定番パターン
Option Explicit
#If VBA7 Then
' 64bit VBA(PtrSafe必須・ハンドルはLongPtr)
Private Declare PtrSafe Function FindWindow Lib "user32" _
Alias "FindWindowA" (ByVal lpClassName As String, _
ByVal lpWindowName As String) As LongPtr
Private Declare PtrSafe Function GetTickCount Lib "kernel32" () As Long
#Else
' 旧32bit VBA
Private Declare Function FindWindow Lib "user32" _
Alias "FindWindowA" (ByVal lpClassName As String, _
ByVal lpWindowName As String) As Long
Private Declare Function GetTickCount Lib "kernel32" () As Long
#End If
Sub CATMain()
' ハンドルを受ける変数もVBA7ではLongPtrで宣言する
#If VBA7 Then
Dim hWnd As LongPtr
#Else
Dim hWnd As Long
#End If
hWnd = FindWindow(vbNullString, CATIA.Caption)
If hWnd = 0 Then
MsgBox "CATIAウィンドウが見つかりません", vbExclamation
End If
End Sub' 既定の文字コードに任せず、入出力のたびに明示する
Option Explicit
' UTF-8(BOM付き)でテキストを書き出す
Sub WriteUtf8(ByVal path As String, ByVal body As String)
Dim st As Object
Set st = CreateObject("ADODB.Stream")
st.Type = 2 ' テキストモード
st.Charset = "UTF-8" ' 文字コードを明示
st.Open
st.WriteText body
st.SaveToFile path, 2 ' 2=上書き保存
st.Close
End Sub
' UTF-8のCSVを読み込む(Shift_JIS前提のOpen文では化ける)
Function ReadUtf8(ByVal path As String) As String
Dim st As Object
Set st = CreateObject("ADODB.Stream")
st.Type = 2
st.Charset = "UTF-8"
st.Open
st.LoadFromFile path
ReadUtf8 = st.ReadText(-1) ' -1=全文
st.Close
End Function