ATL マクロリファレンス (アルファベット順)

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ここでは、ATL マクロに関するトピックがアルファベット順に編成されています。カテゴリ別のマクロを探すには、「ATL マクロ」を参照してください。

マクロ	説明
_ATL_ALL_WARNINGS	以前のバージョンの ATL から変換されたプロジェクトのエラーを有効にするシンボルです。
_ATL_APARTMENT_THREADED	1 つ以上のオブジェクトでアパートメントスレッドを使用する場合に定義します。
_ATL_CSTRING_EXPLICIT_CONSTRUCTORS	意図しない変換を防ぐために、特定の CString コンストラクタを明示的に宣言します。
_ATL_DEBUG_INTERFACES	ATL ヘッダーファイルをインクルードする前にこのマクロを定義して、コンポーネントのインターフェイスでの AddRef 呼び出しと Release 呼び出しをすべて出力ウィンドウにトレースします。
_ATL_DEBUG_QI	QueryInterface への呼び出しをすべて出力ウィンドウに書き込みます。
_ATL_FREE_THREADED	1 つ以上のオブジェクトでフリースレッドまたはニュートラルスレッドを使用する場合に定義します。
_ATL_MIXED	ATL アプリケーションがネイティブコンパイル単位と /clr コンパイル単位で構成されることをコンパイラに指定します。
_ATL_MULTI_THREADED	プロジェクトが、[両方]、[フリー]、または [ニュートラル] としてマークされたオブジェクトを持つことを示すシンボルです。新しいコードでは、_ATL_FREE_THREADED マクロを使用します。
_ATL_NO_COM_SUPPORT	COM 関連コードがプロジェクトにコンパイルされないようにするシンボルです。
_ATL_NO_AUTOMATIC_NAMESPACE	ATL として名前空間を既定で使用できないようにするシンボルです。
_ATL_SECURE_NO_WARNINGS	推奨されない ATL 関数の使用に対してコンパイラ警告が発生しないようにします。
_ATL_STATIC_REGISTRY	ATL.DLL に依存するのを避けるために、オブジェクトの登録コードをオブジェクトに指定することを示すシンボルです。
_ATLCATCH	関連付けられた _ATLTRY で発生するエラーを処理するステートメントです。
_ATLCATCHALL	関連付けられた _ATLTRY で発生するエラーを処理するステートメントです。
_ATLTRY	エラーの原因の可能性がある、保護されたコードセクションを示します。
ATL_ESC のフラグ	EscapeXML の動作を制御するために使用するフラグです。
ALT_MSG_MAP	代替メッセージマップの開始位置を示します。
ATL と MFC の文字列変換マクロ	ATL と MFC の両方で有効な文字列変換マクロです。
ATLASSERT	ATLASSERT マクロの機能は、C ランタイムライブラリの _ASSERTE マクロと同じです。
ATL_NOINLINE	関数のインライン展開の禁止を示すシンボルです。
ATL_NO_VTABLE	vtable ポインタがクラスのコンストラクタやデストラクタで初期化されないようにするシンボルです。
ATL_URL のフラグ	AtlEscapeUrl および AtlCanonicalizeUrl の動作を変更するフラグです。
ATL_URL_SCHEME	この列挙型のメンバは、CUrl で認識されるスキームの定数を提供します。
ATL_WORKER_THREAD_WAIT	このマクロは、CWorkerThread::Shutdown がワーカースレッドのシャットダウンまでに待機する既定値をミリ秒単位で定義します。
ATLS_DEFAULT_THREADPOOLSHUTDOWNTIMEOUT	このマクロは、CThreadPool がスレッドのシャットダウンまでに待機する既定時間をミリ秒単位で定義します。
ATLS_DEFAULT_THREADSPERPROC	このマクロは、CThreadPool が使用するプロセッサあたりの既定のスレッド数を定義します。
ATLSMTP_QPENCODE のフラグ	quoted-printable エンコーディングが QPEncode によってどのように実行されるかを示すフラグです。
ATLSMTP_UUENCODE のフラグ	uuencode が UUEncode によってどのように実行されるかを示すフラグです。
ATLTRACE	指定されたフラグとレベルに応じて、デバッガウィンドウなどの出力デバイスに警告を送ります。下位互換性のためにインクルードされます。
ATLTRACE2	指定されたフラグとレベルに応じて、デバッガウィンドウなどの出力デバイスに警告を送ります。
ATLTRACENOTIMPL	ATL のデバッグビルドでは、"funcname がこのコンテキストで実装されていません。" という文字列をダンプデバイスに送り、E_NOTIMPL を返します。
BEGIN_CATEGORY_MAP	カテゴリマップの開始位置を示します。
BEGIN_COM_MAP	COM マップとは、QueryInterface を通じてオブジェクトのインターフェイスをクライアントに公開する機構のことです。
BEGIN_CONNECTION_POINT_MAP	コネクションポイントマップのエントリの開始位置を示します。
BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP	スナップインエクステンションデータクラスマップの開始位置を示します。
BEGIN_MSG_MAP	既定のメッセージマップの開始位置を示します。
BEGIN_PROP_MAP	オブジェクトのプロパティマップの開始位置を示します。
BEGIN_RDX_MAP	レジストリデータエクスチェンジマップの開始位置を示します。
BEGIN_SERVICE_MAP	サービスマップの開始位置を示します。
BEGIN_SINK_MAP	複合コントロールのイベントシンクマップの開始位置を宣言します。
BEGIN_SNAPINTOOLBARID_MAP	スナップインオブジェクトのツールバー ID マップの開始位置を宣言します。
CHAIN_MSG_MAP	メッセージマップにエントリを定義します。
CHAIN_MSG_MAP_ALT	メッセージマップにエントリを定義します。
CHAIN_MSG_MAP_ALT_MEMBER	メッセージマップにエントリを定義します。
CHAIN_MSG_MAP_DYNAMIC	メッセージマップにエントリを定義します。
CHAIN_MSG_MAP_MEMBER	メッセージマップにエントリを定義します。
COM_INTERFACE_ENTRY に関するマクロ	この種のマクロは、オブジェクトのインターフェイスをその COM マップに入力して、QueryInterface がオブジェクトのインターフェイスにアクセスできるようにします。
COM_INTERFACE_ENTRY	COM インターフェイスマップにインターフェイスを入力します。
COM_INTERFACE_ENTRY2	2 つの継承元に関するあいまい性を解決します。
COM_INTERFACE_ENTRY2_IID	COM_INTERFACE_ENTRY2 と同じ機能を提供します。ただし、このマクロでは別の IID を指定できます。
COM_INTERFACE_ENTRY_AGGREGATE	iid で識別されるインターフェイスが問い合わせを受けると、COM_INTERFACE_ENTRY_AGGREGATE は punk に転送します。
COM_INTERFACE_ENTRY_AGGREGATE_BLIND	COM_INTERFACE_ENTRY_AGGREGATE と同じ機能を提供します。ただし、どのような IID についての問い合わせも punk に転送されます。
COM_INTERFACE_ENTRY_AUTOAGGREGATE	COM_INTERFACE_ENTRY_AGGREGATE と同じ機能を提供します。ただし、punk が NULL の場合は、clsid で識別される集約を自動的に作成します。
COM_INTERFACE_ENTRY_AUTOAGGREGATE_BLIND	COM_INTERFACE_ENTRY_AUTOAGGREGATE と同じ機能を提供します。ただし、どのような IID についての問い合わせも punk に転送されます。また、punk が NULL の場合は、clsid で識別される集約を自動的に作成します。
COM_INTERFACE_ENTRY_BREAK	指定されたインターフェイスが問い合わせを受けると、プログラムが DebugBreak を呼び出すようにします。
COM_INTERFACE_ENTRY_CACHED_TEAR_OFF	すべてのインスタンスについてインターフェイス固有のデータを保存します。
COM_INTERFACE_ENTRY_CHAIN	処理が COM マップ内のこのエントリに達したときに、基本クラスの COM マップを処理します。
COM_INTERFACE_ENTRY_FUNC	ATL の QueryInterface ロジックにフックするための一般的な機構です。
COM_INTERFACE_ENTRY_FUNC_BLIND	COM_INTERFACE_ENTRY_FUNC と同じ機能を提供します。ただし、IID について問い合わせると、func が呼び出されます。
COM_INTERFACE_ENTRY_IID	このマクロは、インターフェイスを COM マップに入力し、インターフェイスの IID を指定するために使用します。
COM_INTERFACE_ENTRY_NOINTERFACE	指定されたインターフェイスに対する問い合わせを受けると、E_NOINTERFACE を返し、COM マップの処理を終了します。
COM_INTERFACE_ENTRY_TEAR_OFF	ティアオフインターフェイスを公開します。
COMMAND_CODE_HANDLER	COMMAND_HANDLER と同じ機能を提供します。ただし、通知コードだけに基づいて WM_COMMAND メッセージを割り当てます。
COMMAND_HANDLER	メッセージマップにエントリを定義します。
COMMAND_ID_HANDLER	COMMAND_HANDLER と同じ機能を提供します。ただし、メニュー項目、コントロール、またはアクセラレータの ID だけに基づいて、WM_COMMAND メッセージを割り当てます。
COMMAND_RANGE_CODE_HANDLER	COMMAND_RANGE_HANDLER と同じ機能を提供します。ただし、ある範囲のコントロールの特定の通知コードを使用して、WM_COMMAND メッセージを 1 つのハンドラ関数に割り当てます。
COMMAND_RANGE_HANDLER	COMMAND_HANDLER と同じ機能を提供します。ただし、ある範囲のコントロールの WM_COMMAND メッセージを 1 つのハンドラ関数に割り当てます。
CONNECTION_POINT_ENTRY	指定されたインターフェイス用のコネクションポイントをコネクションポイントマップに入力して、インターフェイスにアクセスできるようにします。
DECLARE_AGGREGATABLE	オブジェクトが集約できるように指定します。
DECLARE_CLASSFACTORY	CComClassFactory がクラスファクトリであることを宣言します。
DECLARE_CLASSFACTORY2	CComClassFactory2 がクラスファクトリであることを宣言します。
DECLARE_CLASSFACTORY_AUTO_THREAD	CComClassFactoryAutoThread がクラスファクトリであることを宣言します。
DECLARE_CLASSFACTORY_EX	cf がクラスファクトリであることを宣言します。
DECLARE_CLASSFACTORY_SINGLETON	CComClassFactorySingleton がクラスファクトリであることを宣言します。
DECLARE_EMPTY_MSG_MAP	空のメッセージマップを宣言します。
DECLARE_GET_CONTROLLING_UNKNOWN	GetControllingUnknown 仮想関数を宣言します。
DECLARE_LIBID	ATL がタイプライブラリの libid を取得する方法を提供します。
DECLARE_NO_REGISTRY	DECLARE_NO_REGISTRY マクロを持つクラスに対して、ATL の既定の登録情報使用しない場合は、このマクロを使用します。
DECLARE_NOT_AGGREGATABLE	オブジェクトが集約できないことを指定します。
DECLARE_OBJECT_DESCRIPTION	クラスオブジェクトを説明する文字列を指定できます。
DECLARE_OLEMISC_STATUS	OLEMISC フラグを設定するために、ATL ActiveX コントロールで使用します。
DECLARE_ONLY_AGGREGATABLE	オブジェクトを集約する必要があることを指定します。
DECLARE_POLY_AGGREGATABLE	オブジェクトを作成するときは、CComPolyObject<x > のインスタンスが作成されるように指定します。
DECLARE_PROTECT_FINAL_CONSTRUCT	FinalConstruct の実行中、集約される内部オブジェクトが参照カウントをインクリメントし、その後カウントを 0 にデクリメントした場合でも、オブジェクトが削除されないように保護します。
DECLARE_REGISTRY	クラスの標準的な登録情報をレジストリに入力したり、レジストリから登録情報を削除したりします。
DECLARE_REGISTRY_APPID_RESOURCEID	appid の自動登録に必要な情報を指定します。
DECLARE_REGISTRY_RESOURCE	レジストリファイルが含まれている名前付きリソースを取得し、レジストリにオブジェクトを登録あるいは削除するためにスクリプトを実行します。
DECLARE_REGISTRY_RESOURCEID	DECLARE_REGISTRY_RESOURCE と同じ機能を提供します。ただし、リソースを識別するときに、文字列名ではなく、ウィザードが生成した UINT を使用します。
DECLARE_VIEW_STATUS	このマクロを ATL ActiveX コントロールのコントロールクラスに入れて、コンテナに対する VIEWSTATUS フラグを指定します。
DECLARE_WND_CLASS	新しいウィンドウクラスの名前を指定できます。このマクロを ATL ActiveX コントロールのコントロールクラスに入れます。
DECLARE_WND_CLASS_EX	新しいウィンドウクラスの基になる既存のウィンドウクラスの名前を指定できます。このマクロを ATL ActiveX コントロールのコントロールクラスに入れます。
DECLARE_WND_SUPERCLASS	クラスのパラメータを指定できます。このマクロを ATL ActiveX コントロールのコントロールクラスに入れます。
DEFAULT_REFLECTION_HANDLER	戻されたメッセージを受け取る子ウィンドウ (コントロール) の既定のハンドラを提供します。ハンドラは、処理されていないメッセージを DefWindowProc に渡します。
DEVMODE および TEXTMETRIC の各文字列変換マクロ	これらのマクロは、DEVMODE 構造体または TEXTMETRIC 構造体のコピーを作成し、このコピー内の文字列を新しい文字列型に変換します。
END_CATEGORY_MAP	カテゴリマップの終了位置を示します。
END_COM_MAP	COM インターフェイスマップの定義を終了します。
END_CONNECTION_POINT_MAP	コネクションポイントマップのエントリの終了位置を示します。
END_EXTENSION_SNAPIN_NODEINFO_MAP	スナップインエクステンションデータクラスマップの終了位置を示します。
END_MSG_MAP	メッセージマップの終了位置を示します。
END_PROP_MAP	オブジェクトのプロパティマップの終了位置を示します。
END_RDX_MAP	レジストリデータエクスチェンジマップの終了位置を示します。
END_SERVICE_MAP	サービスマップの終了位置を示します。
END_SINK_MAP	複合コントロールのイベントシンクマップの終了位置を宣言します。
END_SNAPINTOOLBARID_MAP	スナップインオブジェクトのツールバー ID マップの終了位置を宣言します。
EXTENSION_SNAPIN_DATACLASS	ISnapInItemImpl 派生クラスのスナップインエクステンションデータクラスにデータメンバを追加します。
EXTENSION_SNAPIN_NODEINFO_ENTRY	スナップインエクステンションデータクラスをスナップインエクステンションデータクラスマップに追加します。
FORWARD_NOTIFICATIONS	親ウィンドウに通知メッセージを転送します。
IMPLEMENTED_CATEGORY	IMPLEMENTED_CATEGORY マクロをコンポーネントのカテゴリマップに追加して、そのマップが catID パラメータで識別されるカテゴリを実装するものとして登録されるように指定します。
MESSAGE_HANDLER	メッセージマップにエントリを定義します。
MESSAGE_RANGE_HANDLER	MESSAGE_HANDLER と同じ機能を提供します。ただし、ある範囲の Windows メッセージを 1 つのハンドラ関数に割り当てます。
NOTIFY_CODE_HANDLER	NOTIFY_HANDLER と同じ機能を提供します。ただし、通知コードだけに基づいて WM_NOTIFY メッセージを割り当てます。
NOTIFY_HANDLER	メッセージマップにエントリを定義します。
NOTIFY_ID_HANDLER	NOTIFY_HANDLER と同じ機能を提供します。ただし、コントロール ID だけに基づいて、WM_NOTIFY メッセージを割り当てます。
NOTIFY_RANGE_CODE_HANDLER	NOTIFY_RANGE_HANDLER と同じ機能を提供します。ただし、ある範囲のコントロールの特定の通知コードを持つ WM_NOTIFY メッセージを 1 つのハンドラ関数に割り当てます。
NOTIFY_RANGE_HANDLER	NOTIFY_HANDLER と同じ機能を提供します。ただし、ある範囲のコントロールの WM_NOTIFY メッセージを 1 つのハンドラ関数に割り当てます。
OBJECT_ENTRY_AUTO	ATL オブジェクトをオブジェクトマップに入力し、レジストリを更新します。さらに、ATL オブジェクトのインスタンスを生成します。
OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO	オブジェクトを登録して初期化するように指定する一方で、CoCreateInstance を使用してオブジェクトを外部で作成できないように指定できます。
PROP_DATA_ENTRY	ActiveX コントロールのエクステント、つまり大きさを示します。
PROP_ENTRY_TYPE	プロパティの説明、プロパティの DISPID、およびプロパティページの CLSID をオブジェクトのプロパティマップに入力します。
PROP_ENTRY_TYPE_EX	PROP_ENTRY_TYPE と同じ機能を提供します。ただし、オブジェクトが複数のデュアルインターフェイスをサポートしている場合は、特定の IID を指定できます。
PROP_PAGE	プロパティページの CLSID をオブジェクトのプロパティマップに入力します。
RDX_BINARY	指定したレジストリエントリを BYTE 型の指定したメンバ変数に関連付けます。
RDX_CSTRING_TEXT	指定したレジストリエントリを CString 型の指定したメンバ変数に関連付けます。
RDX_DWORD	指定したレジストリエントリを DWORD 型の指定したメンバ変数に関連付けます。
RDX_TEXT	指定したレジストリエントリを TCHAR 型の指定したメンバ変数に関連付けます。
REFLECT_NOTIFICATIONS	通知メッセージを送信元の子ウィンドウ (コントロール) に戻します。
REFLECTED_COMMAND_CODE_HANDLER	COMMAND_CODE_HANDLER と同じ機能を提供します。ただし、親ウィンドウから返されたコマンドを割り当てます。
REFLECTED_COMMAND_HANDLER	COMMAND_HANDLER と同じ機能を提供します。ただし、親ウィンドウから返されたコマンドを割り当てます。
REFLECTED_COMMAND_ID_HANDLER	COMMAND_ID_HANDLER と同じ機能を提供します。ただし、親ウィンドウから返されたコマンドを割り当てます。
REFLECTED_COMMAND_RANGE_CODE_HANDLER	COMMAND_RANGE_CODE_HANDLER と同じ機能を提供します。ただし、親ウィンドウから返されたコマンドを割り当てます。
REFLECTED_COMMAND_RANGE_HANDLER	COMMAND_RANGE_HANDLER と同じ機能を提供します。ただし、親ウィンドウから返されたコマンドを割り当てます。
REFLECTED_NOTIFY_CODE_HANDLER	NOTIFY_CODE_HANDLER と同じ機能を提供します。ただし、親ウィンドウから返された通知を割り当てます。
REFLECTED_NOTIFY_HANDLER	NOTIFY_HANDLER と同じ機能を提供します。ただし、親ウィンドウから返された通知を割り当てます。
REFLECTED_NOTIFY_ID_HANDLER	NOTIFY_ID_HANDLER と同じ機能を提供します。ただし、親ウィンドウから返された通知を割り当てます。
REFLECTED_NOTIFY_RANGE_CODE_HANDLER	NOTIFY_RANGE_CODE_HANDLER と同じ機能を提供します。ただし、親ウィンドウから返された通知を割り当てます。
REFLECTED_NOTIFY_RANGE_HANDLER	NOTIFY_RANGE_HANDLER と同じ機能を提供します。ただし、親ウィンドウから返された通知を割り当てます。
REQUIRED_CATEGORY	REQUIRED_CATEGORY マクロをコンポーネントのカテゴリマップに追加して、そのマップが catID パラメータで識別されるカテゴリを必要とするものとして登録されるように指定します。
SERVICE_ENTRY	オブジェクトが SID で指定されたサービス ID をサポートすることを示します。
SERVICE_ENTRY_CHAIN	punk で指定されたオブジェクトにチェインするように IServiceProviderImpl::QueryService に指示します。
SINK_ENTRY	id で識別されるコントロールの、指定されたイベント (dispid) に対するハンドラ関数 (fn) を宣言します。
SINK_ENTRY_EX	id で識別されるコントロールのディスパッチインターフェイス (iid) の、指定されたイベント (dispid) に対するハンドラ関数 (fn) を宣言します。
SINK_ENTRY_INFO	イベントシンクマップ内で SINK_ENTRY_INFO マクロを使用して、関連するハンドラ関数にイベントをルーティングするために IDispEventSimpleImpl で必要な情報を提供します。
SNAPINMENUID	スナップインオブジェクトのコンテキストメニューリソースを宣言します。
SNAPINTOOLBARID_ENTRY	ツールバー ID をスナップインオブジェクトのツールバー ID マップに入力します。
WM_FORWARDMSG	あるウィンドウが受け取ったメッセージを処理のために別のウィンドウに転送します。