Método IObjectWithSite::SetSite (ocidl.h)

  • Artigo

Permite que um contêiner passe um objeto um ponteiro para a interface de seu site.

Sintaxe

HRESULT SetSite(
  [in] IUnknown *pUnkSite
);

Parâmetros

[in] pUnkSite

Um ponteiro para o ponteiro da interface IUnknown do site que gerencia esse objeto. Se FOR NULL, o objeto deverá chamar Release em qualquer site existente, momento em que o objeto não conhece mais seu site.

Retornar valor

Esse método retorna S_OK com êxito.

Comentários

O objeto deve manter esse ponteiro chamando IUnknown::AddRef ao fazer isso. Se o objeto já tiver um site, ele deverá chamar IUnknown::Release do site existente, salvar o novo ponteiro do site e chamar IUnknown::AddRef do novo site.

E_NOTIMPL não é permitido. Sem a implementação do método SetSite , a interface IObjectWithSite é desnecessária.

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 ocidl.h

Confira também

Iobjectwithsite