RtwqCreateAsyncResult function (rtworkq.h)

Creates an asynchronous result object. Use this function if you are implementing an asynchronous method.

Syntax

HRESULT RtwqCreateAsyncResult(
  [in]  IUnknown           *appObject,
  [in]  IRtwqAsyncCallback *callback,
  [in]  IUnknown           *appState,
  [out] IRtwqAsyncResult   **asyncResult
);

Parameters

[in] appObject

Pointer to the object stored in the asynchronous result. This pointer is returned by the IRtwqAsyncResult::GetObject method. This parameter can be NULL.

[in] callback

Pointer to the IRtwqAsyncCallback interface. This interface is implemented by the caller of the asynchronous method.

[in] appState

Pointer to the IUnknown interface of a state object. This value is provided by the caller of the asynchronous method. This parameter can be NULL.

[out] asyncResult

Receives a pointer to the IRtwqAsyncResult interface. The caller must release the interface.

Return value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

To invoke the callback specified in pCallback, call the RtwqInvokeCallback function.

Requirements