VC++ #import

#import <ファイル名>

COMのタイプライブラリを含んだDLL（やEXE等？の）ファイルを指定すると、その中のタイプライブラリを取り込んでくれる。
VB等で「参照設定」と言われている仕組みに相当していると思われる。

• #importの概要
• #importでよく出る警告
  • C4192
  • C4278
• #importの属性
• #import専用ファイルの勧め

概要

#importが書かれているソースをコンパイルすると、拡張子がtlhとtliのファイルが作られる。
そして、tlhが（#includeしたかのように）読み込まれる。（tliも自動的にコンパイルされる）

例えば「#import <shdocvw.dll>」により、プロジェクトのワークディレクトリ内（デバッグビルドなら「Debugディレクトリ」の下）に「shdocvw.tlh」と「shdocvw.tli」というファイルが作られる。

コンパイル時の警告

shdocvw.dllやmshtml.tlbをインポートすると、コンパイル時に警告が出る。（VC++2005）

#import <shdocvw.dll>
#import <mshtml.tlb>

warning C4192

'tagREADYSTATE' を自動的に除外し、タイプ ライブラリ 'shdocvw.dll' をインポートします

tagREADYSTATEが他の場所（ocidl.hの中）で既に定義されているので、shdocvw.tlhの中ではtagREADYSTATEを定義しない（除外する）。そのままインポートを続行する。
という意味。

この警告を消すには以下のような方法がある。

• exclude属性を用いて明示的に除外する。
• no_auto_exclude属性を指定して定義する（除外しない）。 重複して定義されることになるのだが、コンパイルエラーにもならないし、問題は無さげ。
• #pragma warningを使って警告を抑制する（除外はする）。

warning C4278

'FindText': タイプ ライブラリ 'shdocvw.dll' の識別子は既にマクロです。'rename' 修飾子を使用してください。

例によって変な日本語だが、要するに、shdocvw.dllの中で使っている「FindText」という識別子が 既に別の場所でマクロとして定義されている（commdlg.hで#defineしている）ので、rename属性を使って変更しろ、ということ。

この警告を消すには以下のような方法がある。

• rename属性を用いてタイプライブラリ内の識別子の名前を変更する。
• auto_rename属性を用いてタイプライブラリ内の識別子の名前を自動的に変更する。

属性（修飾子）

#importでは、後ろに各種の属性を付与することが出来る。

属性は、スペース区切りまたはカンマ区切りで複数指定することが出来る。
また、行末に「\」を置くことにより、複数行にまたがって指定することが出来る。（#define等の普通のプリプロセッサ命令と一緒）

属性は他にもあるようだ。VisualStudioのヘルプを参照。
VC++2005の場合、メニューバーの「ヘルプ(H)」→「カテゴリから検索(D)」でヘルプ画面を出し、URLに#import Attributesのものを入力すると属性一覧が表示される。（VisualStudioがインストールされている場合、InternetExplorerでそのURLを入力することでも表示される！ただしローカル以外からのリンククリックでは何も動作しない。VS2005がインストールされていない環境では、遷移はするが“無効なURL”のエラーになる）

もしくは、MSDNで。

import専用ファイルの勧め

A.cppとB.cppがそれぞれ同じdllを#importしたとする。その際、#importの属性が違うと…

1. A.cppの属性でtlhとtliファイルが作られる。
2. その後、B.cppの属性でtlhとtliファイルが作られる。その際、作られる場所は同じなので、上書きされる。
3. それをVisualStudioが検知し、「このファイルはリソースエディタ以外で変更されました。再度読み込みますか？」というダイアログが表示される。（“このファイル”というのは、tlhやtliのことだろう）
4. 「はい」を選ぶと、A.cppによる再作成が行われ、上書きされる。これがVSに検知されて上記のダイアログが出る。
5. 以下、繰り返し(苦笑)

したがって、別々のソースで同じファイルを#importするなら属性は同じにしないといけない。

しかし全ての#importに同じ属性を書くのは面倒（特に属性を色々付けていると）なので、#importするファイルは1つだけにして、他のソースからはtlhファイルを#includeするようにするとよい。
ただし、DebugビルドとReleaseビルドでtlhとtliファイルの作られる場所が違うので、場合分けする必要がある。

import.cpp：

#import <shdocvw.dll> auto_rename \
	exclude("OLECMDID","OLECMDF", "OLECMDEXECOPT","tagREADYSTATE")

#import <mshtml.tlb> auto_rename \
	exclude("_userHGLOBAL","wireHWND","wireHDC","_userHBITMAP","_userBITMAP", \
	"_RemotableHandle","_FLAGGED_BYTE_BLOB","IEnumUnknown" \
	"tagRECT","tagPOINT","tagSIZE", \
	"__MIDL_IWinTypes_0003","__MIDL_IWinTypes_0007","__MIDL_IWinTypes_0009")

A.cpp： B.cpp：

#ifdef _DEBUG
#include "Debug/shdocvw.tlh"
#include "Debug/mshtml.tlh"
#else
#include "Release/shdocvw.tlh"
#include "Release/mshtml.tlh"
#endif

…なんちゃって。素直に#import専用のヘッダーファイルを用意すればいい(爆)

import.h：

#pragma once

#import <shdocvw.dll> auto_rename \
	exclude("OLECMDID","OLECMDF", "OLECMDEXECOPT","tagREADYSTATE")

#import <mshtml.tlb> auto_rename \
	exclude("_userHGLOBAL","wireHWND","wireHDC","_userHBITMAP","_userBITMAP", \
	"_RemotableHandle","_FLAGGED_BYTE_BLOB","IEnumUnknown", \
	"tagRECT","tagPOINT","tagSIZE", \
	"__MIDL_IWinTypes_0003","__MIDL_IWinTypes_0007","__MIDL_IWinTypes_0009")

A.cpp： B.cpp：

#include "import.h"

しかしexcludeに関して、なんでauto_excludeという属性は無いんだろう…？ C4192の警告が出てるだけで、デフォルト動作は自動除外だからか？
ということは、#pragma warningで警告を抑制するだけでもいいのか。

import.h：

#pragma once

#pragma warning(disable:4192)
#import <shdocvw.dll> auto_rename
#import <mshtml.tlb> auto_rename
#pragma warning(default:4192)

…実際、excludeで全項目を列挙するのと同じ内容が生成された。全項目を列挙する苦労の意味は…？(苦笑)

参考

• 矢嶋 聡さんのC++でCOMクライアント …named_guidsやraw_interfaces_only
• ウジャシリさんのFormタグ内のInput(type="button")をクリック