Share via

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

  • Artigo

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
);

Parâmetros

[in] clsid

Tipo: REFCLSID

Uma referência a um CLSID.

[in] pUnkOuter

Tipo: IUnknown*

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.

Retornar valor

Tipo: HRESULT

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

Comentários

Esse método pode ser usado com GetPropertyStoreWithCreateObject.

Requisitos

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