Metodo ITypeInfo::CreateInstance (oaidl.h)

  • Articolo

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