ICreateObject::CreateObject-Methode (propsys.h)

Artikel
03/01/2024

Erstellt ein lokales Objekt einer angegebenen Klasse und gibt einen Zeiger auf eine angegebene Schnittstelle für das -Objekt zurück.

Syntax

HRESULT CreateObject(
  [in]  REFCLSID clsid,
  [in]  IUnknown *pUnkOuter,
  [in]  REFIID   riid,
  [out] void     **ppv
);

Parameter

[in] clsid

Typ: REFCLSID

Ein Verweis auf eine CLSID.

[in] pUnkOuter

Typ: IUnknown*

Ein Zeiger auf die IUnknown-Schnittstelle , die das von dieser Funktion erstellte Objekt aggregiert, oder NULL , wenn keine Aggregation gewünscht ist.

[in] riid

Typ: REFIID

Ein Verweis auf die IID der Schnittstelle, die vom erstellten Objekt zurückgegeben werden soll.

[out] ppv

Typ: void**

Wenn diese Methode zurückgibt, enthält die Adresse des Zeigers auf die in riid angeforderte Schnittstelle.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode kann mit GetPropertyStoreWithCreateObject verwendet werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	propsys.h

Freigeben über