async

The async attribute defines a remote procedure call as an asynchronous operation.

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

Example:

//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

Remarks

To declare an RPC function as asynchronous, first declare the function as part of an interface definition in an IDL file. Then modify that function declaration, within the application configuration (ACF) file, by applying the async attribute. Notice that the function declaration makes no mention of the asynchronous handle, and the binding handle is the first parameter. Applying the async attribute in the ACF file generates the appropriate code so that when this function is called the asynchronous server expects to receive an asynchronous handle before the other parameters.

See Also

Application Configuration (ACF) File, ACF, Asynchronous RPC