Método ICreateObject::CreateObject (propsys.h)

Cria um objeto local de uma classe especificada e retorna um ponteiro para uma interface especificada no objeto .

Sintaxe

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

[in] clsid

Tipo: REFCLSID

Uma referência a um CLSID.

[in] pUnkOuter

Um ponteiro para a interface IUnknown que agrega o objeto criado por essa função ou NULL se nenhuma agregação for desejada.

[in] riid

Tipo: REFIID

Uma referência à IID da interface que o objeto criado deve retornar.

[out] ppv

Tipo: void**

Quando esse método retorna, contém o endereço do ponteiro para a interface solicitada em riid.

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Esse método pode ser usado com GetPropertyStoreWithCreateObject.

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	propsys.h