Função OleCreateDefaultHandler (ole2.h)
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 |