CATIA

VBAの64bit問題と文字コード——古いマクロが動かない時の定番対処

2026.01.14 / 読了目安 8分 / 執筆: Qronix 開発チーム

#CATIA#CATIAマクロ

年明けはPC入れ替えと環境更新の季節だ。そして毎年この時期に増える相談が「昔から使っているCATIAマクロが新しいPCで動かない」。原因は九分九厘、2つに絞られる。VBAの64bit問題と文字コード問題だ。現場で使い続けている定番の対処を、コード付きでまとめる。

整理されたデスクPhoto: Unsplash
CONTENTS
1. 「動かないマクロ」の正体は2つしかない 2. 64bit問題——Declare文にPtrSafeを 3. 文字コード問題——CSVが化ける理由 4. 移行チェックの手順 5. 移行を機に、資産の棚卸しと配布を見直す

「動かないマクロ」の正体は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でだけ落ちる不具合を新たに仕込むことになる。

環境が変わり、
コードが取り残されただけだ。

不動マクロの原因内訳(私たちの相談実感)Declare文の64bit非対応6割コンパイルエラーで即死する文字コード不整合3割動くが日本語が化ける参照設定・その他1割OCX・ライブラリ欠落など
原因の型は2つに集約される。型が分かれば対処も型で済む

文字コード問題——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文と混同しやすい。エラーの原因がコードか参照かを最初に切り分けると早い。

点検は騒ぎが起きる前の平時にやるのが一番安い。数百本の資産があっても、検索と分類だけなら数時間で終わる。動かなくなってから業務を止めて直すのと、どちらが安いかは言うまでもない。

新環境への移行前チェック✓全マクロでDeclare文を検索した✓ハンドル・ポインタをLongPtrに直した✓入出力の文字コードを明示した✓32bit時代のOCX・参照設定を洗い出した✗使われていないマクロを廃棄対象にした✗再配布をサーバー同期型に切り替えた
平時の点検が一番安い。検索と分類だけなら数時間
新環境へ移す前の点検順1Declare文の有無を全ファイルで検索Declareを含むマクロだけがコンパイルエラー候補2Open と FileSystemObject の使用箇所を洗う入出力の文字コードが明示されているかを見る3参照設定とActiveXコントロールを確認参照エラーはコンパイルエラーの顔をして現れる。原因がコードか参照かを先に切り分ける4直す価値のないものを外す全部直そうとせず、使われているものだけ直す
図3: 数百本あっても、検索と分類だけなら数時間で終わる。騒ぎが起きる前の平時にやるのが一番安い。

移行を機に、資産の棚卸しと配布を見直す

64bit対応の作業をしていると、必ず気づくことがある。直す価値のないマクロが山ほどあることだ。作者が退職し、用途も分からず、ただコピーされ続けてきたファイル。移行はこれを捨てる絶好の機会だ。全部直そうとせず、使われているものだけ直す。作らない勇気は、直さない勇気でもある。

直したマクロをメール添付で再配布したら、また同じことの繰り返しになる。せっかく手を入れるなら、サーバー1か所に正本を置く配布の仕組みとセットで移行することを勧めたい。環境更新は、散らかった資産を仕組みに載せ替える数年に一度の好機だ。

私たちも顧客環境の世代交代のたびに、この棚卸しと載せ替えを支援してきた。動かないという悲鳴から始まった作業が、資産一覧と配布基盤が整って終わる。転んでもただでは起きない移行にしてほしい。

手元の作業がこの方法で楽になりそうか、判断が付かないときは相談してください。効果が出そうか出なさそうかを、着手前に金額で見立てるところまでお手伝いします。

マクロを新環境へ移す点検マクロ資産を新環境へ移す今も使われている?直さない移行を機に捨てるDeclare文を含む?PtrSafe・LongPtrで宣言し直す入出力の文字コードを明示している?ADODB.Streamで文字コードを宣言参照設定とActiveXを確認サーバー1か所に正本を置いて配布新環境で運用いいえはい含む含まないいいえはい
図4: 使われているものだけを残し、Declare文と文字コードを直して、正本を1か所に置いて配布するまで。
VBA参考実装例:32bit/64bit両対応のDeclare文
' 条件付きコンパイルで新旧環境の両方を通す定番パターン
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
VBA参考実装例:ADODB.StreamでUTF-8のCSVを読み書きする
' 既定の文字コードに任せず、入出力のたびに明示する
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
Qronix 開発チーム

CATIA歴22年超・愛知県の大手自動車メーカー及びグループ各社でCATIAツール開発の技術責任者を務めたメンバーを中心とする、CAD自働化のスペシャリスト集団。2024年創業、特許第7907964号を保有。

「うちの資産でもできる?」
まずその質問からどうぞ。

できる・できないの判定と自働化設計書のご提案までは無料です。

contact@qronix.jp へ相談する
記事一覧をすべて見る →
← 記事一覧へトップページへ →