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 |
---|---|
|
Não há nenhum site, caso em que *ppvSite contém NULL no retorno. |
|
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 |