ICallFactory::CreateCall-Methode (objidl.h)

Artikel
03/04/2024

Erstellt eine instance des Aufrufobjekts, das einer angegebenen asynchronen Schnittstelle entspricht.

Syntax

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

Parameter

[in] riid

Ein Verweis auf den Bezeichner für die asynchrone Schnittstelle.

[in] pCtrlUnk

Ein Zeiger auf das steuernde IUnknown des Aufrufobjekts. Wenn dieser Parameter nicht NULL ist, wird das Aufrufobjekt im angegebenen Objekt aggregiert, und der riid2-Parameter muss IID_IUnknown sein. Wenn dieser Parameter NULL ist, wird das Aufrufobjekt nicht aggregiert.

[in] riid2

Der Bezeichner einer Schnittstelle für das Aufrufobjekt. Typische Werte sind IID_IUnknown und IID_ISynchronize.

[out] ppv

Die Adresse eines Zeigers auf die von riid2 angegebene Schnittstelle. Dieser Parameter darf nicht NULL sein.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY und E_UNEXPECTED sowie die folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Das Aufrufobjekt wurde erfolgreich erstellt.
E_NOINTERFACE	Der riid-Parameter verweist nicht auf den Bezeichner für die asynchrone Schnittstelle, z. B. IID_AsyncIEventSourceCallback.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	objidl.h (include ObjIdl.h)

Weitere Informationen

ICallFactory

Freigeben über