Metodo ITypeInfo::CreateInstance (oaidl.h)

Articolo
03/05/2024

Crea una nuova istanza di un tipo che descrive una classe oggetto componente (coclasse).

Sintassi

HRESULT CreateInstance(
  [in]  IUnknown *pUnkOuter,
  [in]  REFIID   riid,
  [out] PVOID    *ppvObj
);

Parametri

[in] pUnkOuter

Controllo di IUnknown. Se Null, viene creata un'istanza autonoma. Se valido, viene creato un oggetto di aggregazione.

[in] riid

ID per l'interfaccia che il chiamante userà per comunicare con l'oggetto risultante.

[out] ppvObj

Istanza dell'oggetto creato.

Valore restituito

Codice restituito	Descrizione
S_OK	Operazione completata.
E_INVALIDARG	Uno o più argomenti non sono validi.
E_OUTOFMEMORY	Memoria insufficiente per completare l'operazione.
E_NOINTERFACE	OLE non è riuscito a trovare un'implementazione di una o più interfacce necessarie.

È possibile che vengano restituiti altri errori da GetActiveObject o CoCreateInstance.

Commenti

Per i tipi che descrivono una classe oggetto componente (coclasse), CreateInstance crea una nuova istanza della classe . In genere , CreateInstance chiama CoCreateInstance con il GUID della descrizione del tipo. Per un oggetto Application, chiama innanzitutto GetActiveObject. Se l'applicazione è attiva, GetActiveObject restituisce l'oggetto attivo; in caso contrario, se GetActiveObject ha esito negativo, CreateInstance chiama CoCreateInstance.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	oaidl.h

Vedi anche

Itypeinfo

Condividi tramite