async 属性

  • [アーティクル]

[async] ACF 属性は、リモート プロシージャ呼び出しを非同期操作として定義します。

[async, opt-acf-attributes] function-name (param-list)

パラメーター

opt-acf-attributes

省略可能なアプリケーション構成属性を指定します。

function-name

IDL ファイル内の関数の名前を指定します。

param-list

省略可能なパラメーター リストを指定します。

解説

この属性は、COM インターフェイスでは適用できません。

RPC 関数を非同期として宣言するには、まず IDL ファイル内のインターフェイス定義の一部として関数を宣言します。 次に、[async] 属性を適用して、アプリケーション構成ファイル (ACF) 内でその関数宣言を変更します。 関数宣言では非同期ハンドルのメンションがなく、バインド ハンドルが最初のパラメーターであることに注意してください。 ACF ファイルに [async] 属性を適用すると、適切なコードが生成されるため、この関数が呼び出されると、非同期サーバーは他のパラメーターの前に非同期ハンドルを受け取ることを想定します。

Note

async 属性は、 /osf コマンド ライン スイッチでは使用できません。

 

例

//file:Xasync.idl
interface AsyncIface 
{
    HRESULT MyAsyncFunc (
        handle_t hBinding,
        [in] int a,
        [in] int b,
        [out] int *c) ;
//other interface definitions
}
//end XAsync.idl

// file: Xasync.acf
interface AsyncIface
{
    [async] MyAsyncFunc () ;
    //any other ACF definitions
}
//end Xasync.acf

関連項目

アプリケーション構成ファイル (ACF)

非同期 RPC