Função OleCreateDefaultHandler (ole2.h)

  • Artigo

Cria uma nova instância do manipulador de inserção padrão. Essa instância é inicializada para que ela crie um servidor local quando o objeto inserido entrar no estado em execução.

Sintaxe

HRESULT OleCreateDefaultHandler(
  [in]  REFCLSID  clsid,
  [in]  LPUNKNOWN pUnkOuter,
  [in]  REFIID    riid,
  [out] LPVOID    *lplpObj
);

Parâmetros

[in] clsid

CLSID identificando o servidor OLE a ser carregado quando o objeto inserido entra no estado em execução.

[in] pUnkOuter

Ponteiro para a interface IUnknown de controle se o manipulador deve ser agregado; NULL se não for para ser agregado.

[in] riid

Referência ao identificador da interface, geralmente IID_IOleObject, por meio do qual o chamador se comunicará com o manipulador.

[out] lplpObj

Endereço da variável de ponteiro que recebe o ponteiro de interface solicitado em riid. Após o retorno bem-sucedido, *ppvObj contém o ponteiro de interface solicitado no manipulador recém-criado.

Retornar valor

Essa função retorna NOERROR com êxito e dá suporte ao valor de retorno padrão E_OUTOFMEMORY.

Comentários

OleCreateDefaultHandler cria uma nova instância do manipulador de inserção padrão, inicializado para que ele crie um servidor local identificado pelo parâmetro clsid quando o objeto inserido entra no estado em execução. Se você estiver escrevendo um manipulador e quiser usar os serviços do manipulador padrão, chame OleCreateDefaultHandler. O OLE também o chama internamente quando o CLSID especificado em uma chamada de criação de objeto não é registrado.

Se a classe fornecida não tiver um manipulador especial, uma chamada para OleCreateDefaultHandler produzirá os mesmos resultados de uma chamada para a função CoCreateInstance com o parâmetro de contexto de classe atribuído ao valor CLSCTX_INPROC_HANDLER.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ole2.h
Biblioteca Ole32.lib
DLL Ole32.dll

Confira também

CLSCTX

Cocreateinstance