Método IObjectWithSite::SetSite (ocidl.h)
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 |