oleautomation 属性

[アーティクル]
06/13/2023

oleautomation 属性は、インターフェイスが Automation と互換性があることを示します。

[ 
    oleautomation, 
    uuid(string-uuid)
    [ , interface-attribute-list] 
] 
interface interface-name : base-interface
{
    ...
}

パラメーター

string-uuid: Uuidgen ユーティリティによって生成される UUID 文字列を指定します。
interface-attribute-list: インターフェイス全体に適用される他の属性を指定します。
interface-name: インターフェイスの名前を指定します。
base-interface: この派生インターフェイスがメンバー関数、状態コード、およびインターフェイス属性を継承する Automation インターフェイスの名前を指定します。すべてのオートメーションインターフェイスは、 IUnknown または IDispatch から派生します。

解説

[oleautomation] インターフェイスのメンバーに指定するパラメーターと戻り値の型は、次の表に示すように Automation 互換である必要があります。

型	Description
boolean	値をVARIANT_TRUEまたはVARIANT_FALSEできるデータ項目。サイズはVARIANT_BOOLに対応します。
unsigned char	8 ビット符号なしデータ項目。
double	64 ビット IEEE 浮動小数点数。
float	32 ビット IEEE 浮動小数点数。
int	システムに依存するサイズの符号付き整数。 32 ビットプラットフォームでは、MIDL は int を 32 ビット符号付き整数として扱います。
long	32 ビット符号付き整数
short	16 ビット符号付き整数。
BSTR	Automation トピック BSTR で説明されているように、長さのプレフィックス付き文字列。
CURRENCY	8 バイトの固定浮動小数点数。
DATE	1899 年 12 月 30 日以降の 64 ビット浮動小数点小数部日数。
Scode	VT_ERRORに対応する 16 ビットシステムの組み込みエラーの種類の場合。
Typedef 列挙型Â myenum	システムに依存するサイズの符号付き整数。
インターフェイス IDispatch *	IDispatch インターフェイスへのポインター (VT_DISPATCH)。
インターフェイス IUnknown *	IDispatch (VT_UNKNOWN) から派生しないインターフェイスへのポインター。 (任意の OLE インターフェイスは、その IUnknown インターフェイスで表すことができます)。
ディスパッチÂ Typename *	IDispatch (VT_DISPATCH) から派生したインターフェイスへのポインター。
コクラスÂ Typename *	コクラス名へのポインター (VT_UNKNOWN)。
[oleautomation] インターフェイスÂ Typename *	IUnknown から派生するインターフェイスへのポインター。
SAFEARRAY(TypeName)	TypeName は、上記のいずれかの型です。これらの型の配列。
Typename*	TypeName は、上記のいずれかの型です。型へのポインター。
10 進数	96 ビット符号なしバイナリ整数を、10 の可変累乗でスケーリングします。 (座標のように) 数値のサイズとスケールを提供する 10 進データ型。

パラメーターの型がオートメーション互換型、オートメーション互換型へのポインター、またはオートメーション互換型の SAFEARRAY である場合、パラメーターは Automation と互換性があります。

戻り値の型が HRESULT、SCODE、または void の場合、戻り値の型は Automation と互換性があります。ただし、MIDL では、インターフェイスメソッドが HRESULT または SCODE を返す必要があります。 void を返した場合、コンパイラエラーが生成されます。

戻り値の型とそのすべてのパラメーターが Automation と互換性がある場合、メンバーは Automation と互換性があります。

インターフェイスは、 IDispatch または IUnknown から派生し、[ oleautomation] 属性を持ち、そのすべての VTBL エントリが Automation と互換性がある場合、Automation と互換性があります。 32 ビットプラットフォームの場合、インターフェイス内のすべてのメソッドの呼び出し規則は STDCALL である必要があります。 16 ビットシステムの場合、すべてのメソッドに CDECL 呼び出し規則が必要です。

すべての ディスパッチインターフェイス は、暗黙的にオートメーション互換です。したがって、dispinterface で [oleautomation] 属性を使用しないでください。

MIDL コンパイラ /osf スイッチを使用してコンパイルする場合、[oleautomation] 属性は使用できません。

Flags

TYPEFLAG_FOLEAUTOMATION

例

library Hello
{
    importlib("stdole32.tlb");
    [
        uuid(12345678-1234-1234-1234-123456789ABC),
        helpstring("Application object for the Hello application."),
        oleautomation,
        dual
    ]
    interface IHello : IDispatch
    {
        // Interface definition statements.
    }

    // Other library definition statements.
}

oleautomation 属性

パラメーター

解説

Flags

例

関連項目

フィードバック

フィードバック

その他のリソース