ICallFactory::CreateCall method

Creates an instance of the call object that corresponds to a specified asynchronous interface.

Syntax


HRESULT CreateCall(
  [in]  REFIID   riid,
  [in]  IUnknown *pCtrlUnk,
  [in]  REFIID   riid2,
  [out] IUnknown **ppv
);

Parameters

riid [in]

A reference to the identifier for the asynchronous interface.

pCtrlUnk [in]

A pointer to the controlling IUnknown of the call object. If this parameter is not NULL, the call object is aggregated in the specified object. If this parameter is NULL, the call object is not aggregated.

riid2 [in]

The identifier of an interface on the call object. Typical values are IID_IUnknown and IID_ISynchronize.

ppv [out]

The address of a pointer to the interface specified by riid2. This parameter cannot be NULL.

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, and E_UNEXPECTED, as well as the following values.

Return codeDescription
S_OK

The call object was created successfully.

E_NOINTERFACE

The riid parameter does not reference the identifier for the asynchronous interface, such as IID_AsyncIEventSourceCallback.

 

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

ObjIdl.h

IDL

ObjIdl.idl

IID

IID_ICallFactory is defined as 1c733a30-2a1c-11ce-ade5-00aa0044773d

See also

ICallFactory

 

 

Show: