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

Recupera o site mais recente passado usando SetSite.

Sintaxe

HRESULT GetSite(
  [in]  REFIID riid,
  [out] void   **ppvSite
);

Parâmetros

[in] riid

O IID do ponteiro de interface que deve ser retornado no ppvSite.

[out] ppvSite

Endereço da variável de ponteiro que recebe o ponteiro de interface solicitado em riid. Após o retorno bem-sucedido, *ppvSite contém o ponteiro de interface solicitado para o site visto pela última vez em SetSite. A interface específica retornada depende do argumento riid . Em essência, os dois argumentos agem de forma idêntica àquelas em QueryInterface. Se o ponteiro de interface apropriado estiver disponível, o objeto deverá chamar AddRef nesse ponteiro antes de retornar com êxito. Se nenhum site estiver disponível ou a interface solicitada não tiver suporte, esse método deverá *ppvSite para NULL e retornar um código de falha.

Retornar valor

Esse método retorna S_OK em caso de êxito. Outros valores retornados possíveis incluem o seguinte.

Código de retorno Descrição
E_FAIL
Não há nenhum site, caso em que *ppvSite contém NULL no retorno.
E_NOINTERFACE
Há um site, mas ele não dá suporte à interface solicitada pelo riid.

Comentários

E_NOTIMPL não é permitido. Qualquer objeto que implemente essa interface deve ser capaz de retornar o último site visto em IObjectWithSite::SetSite.

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