idl_module

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

.dll ファイルのエントリポイントを指定します。

[ idl_module ( 
   name=module_name, 
      dllname=dll, 
      uuid="uuid", 
      helpstring="help text", 
      helpstringcontext=helpcontextID, 
      helpcontext=helpcontext, 
      hidden, 
      restricted
) ]
function declaration

パラメータ

name
.idl ファイルに表示されるコードブロックのユーザー定義名。
dllname (省略可能)
エクスポートを含む .dll ファイル。
uuid (省略可能)
一意の ID。
helpstring (省略可能)
タイプライブラリの記述に使用する文字列。
helpstringcontext (省略可能)
.hlp ファイルまたは .chm ファイルのヘルプトピックの ID。
helpcontext (省略可能)
このタイプライブラリのヘルプ ID。
hidden (省略可能)
ライブラリを非表示にするパラメータ。詳細については、MIDL 属性 hidden を参照してください。
restricted (省略可能)
ライブラリのメンバを任意に呼び出すことができないように指定します。詳細については、MIDL 属性 restricted を参照してください。
function declaration
定義する関数。

解説

C++ 属性 idl_module を設定すると、.dll ファイルにエントリポイントを指定して .dll ファイルからインポートできるようになります。

属性 idl_module の機能は、Microsoft インターフェイス定義言語 (MIDL: Microsoft Interface Definition Language) 属性 module と同じです。

.idl ファイルのライブラリブロックに DLL エントリポイントを配置すると、.dll ファイルからエクスポートできる項目を COM オブジェクトからもエクスポートできます。

idl_module を使用するには、次の 2 つの手順に従います。まず、名前と DLL の組を定義します。次に、idl_module を使用してエントリポイントを指定するときに、名前と任意の追加属性を指定します。

使用例

属性 idl_module の使用例を次のコードに示します。

// cpp_attr_ref_idl_module.cpp
// compile with: /LD
[idl_quote("midl_pragma warning(disable:2461)")];
[module(name="MyLibrary"), idl_module(name="MyLib", dllname="xxx.dll")];
[idl_module(name="MyLib"), entry(4), usesgetlasterror]
void FuncName(int i);