COM IDL定義の[in、out]と[out、retval]の相違点

Question

私が扱うIDLの中には、メソッドに戻り値をマーキングするための2つの慣習があることに気がついています - [in, out]と[out, retval]。

複数の戻り値がある場合[in, out]は、例えば、使用されると思われる：

HRESULT MyMethod2(
    [in] long InputParam, 
    [out, retval] long* OutputParam1 
); 

：

HRESULT MyMethod(
    [in] long InputParam, 
    [in, out] long* OutputParam1, 
    [in, out] long* OutputParam2 
); 

単一の戻り値がある場合[out, retval]は、例えば、使用されると思われます

これはCOM IDLの規約ですか、それとも私が作業しているコードの慣例ですか？

2つの表記法から生成されるコードに機能的な違いがありますか、または完全に互換性がありますか？

Answer 1

[in, out]は、メソッドが呼び出されたときに有効な値が渡され、メソッドが成功を返したときに有効な値（ポインタが指す場所）があることを意味します。 [out]は、メソッドが呼び出されたときにどのような値でも指定できますが、メソッドが成功を返したときに有効になることを意味します。 [out]と[in, out]の両方のパラメータはポインタでなければならず、その値は変更されておらず、有効性要件はそれらが指す変数にのみ適用されます。

[out, retval]は、ネイティブCOMサポートラッパーを作成するときに、この非常にパラメータを戻り値に変換する必要があることを示す構文糖です。

HRESULT IWrappedInterface::MyMethod(long* OutParam1, long* OutParam2); 

のみ、最後の1つの[out]のパラメータ次のことができます。あなたはラッパーが、元のシグネチャを持つメソッドが含まれていますそれを[retval]をマークしていない場合は例えば

HRESULT MyMethod([out] long* OutParam1, [out, retval] long* OutParam2); 

は

long IWrappedInterface::MyMethod(long* OutParam1); 

なり[out, retval]としてマークしてください。 [in, out]のパラメータには[retval]とマークすることはできません。

Answer 2

もう1つの違いは、これがPIAの.NETコードでどのように表示されるかです。

[out、ret]は.NETで戻り値として表示されます。

[out]は、.NETのメソッドに引数を表示します。