nf-objidlbase-icallfactory-createcall.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:objidlbase.ICallFactory.CreateCall	ICallFactory::CreateCall (objidlbase.h)	The ICallFactory::CreateCall (objidlbase.h) method creates an instance of the call object that corresponds to a specified asynchronous interface.	CreateCall CreateCall method [COM] CreateCall method [COM] ICallFactory interface ICallFactory interface [COM] CreateCall method ICallFactory.CreateCall ICallFactory::CreateCall _com_icallfactory_createcall com.icallfactory_createcall objidlbase/ICallFactory::CreateCall	com\icallfactory_createcall.htm	com	8df51aeb-4852-4dab-b1e9-e149ee115ea8	08/13/2022	CreateCall, CreateCall method [COM], CreateCall method [COM],ICallFactory interface, ICallFactory interface [COM],CreateCall method, ICallFactory.CreateCall, ICallFactory::CreateCall, _com_icallfactory_createcall, com.icallfactory_createcall, objidlbase/ICallFactory::CreateCall	objidlbase.h	ObjIdl.h	Windows	Windows 2000 Professional [desktop apps only]	Windows 2000 Server [desktop apps only]					ObjIdl.idl								Windows			19H1	ICallFactory::CreateCall objidlbase/ICallFactory::CreateCall	c++	APIRef kbSyntax	COM	objidlbase.h	ICallFactory.CreateCall

ICallFactory::CreateCall

-description

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

-parameters

-param riid [in]

A reference to the identifier for the asynchronous interface.

-param 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.

-param riid2 [in]

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

-param ppv [out]

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

-returns

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

Return code	Description
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.

-see-also

ICallFactory