Método IShellService::SetOwner (shdeprecated.h)

Preterido. Declara uma referência de proprietário ao objeto de serviço.

Sintaxe

HRESULT SetOwner(
  IUnknown *punkOwner
);

Parâmetros

punkOwner

Tipo: IUnknown*

O endereço de um ponteiro de interface para o objeto proprietário. Se NULL, o objeto deverá chamar IUnknown::Release para liberar a referência existente.

Valor retornado

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

O cliente chama CoCreateInstance para IShellService e chama SetOwner(this) para declarar a propriedade. Quando o cliente é ignorado, normalmente quando a janela é fechada, ele chama SetOwner(NULL) para instruir o objeto de serviço a liberar a referência ao objeto proprietário.

Requisitos