função IUnknown_GetSite (shlwapi.h)

Chama o método IObjectWithSite::GetSite do objeto especificado.

Sintaxe

LWSTDAPI IUnknown_GetSite(
  [in]  IUnknown *punk,
  [in]  REFIID   riid,
  [out] void     **ppv
);

Parâmetros

[in] punk

Tipo: IUnknown*

Um ponteiro para o objeto COM cujo método IObjectWithSite::GetSite deve ser chamado.

[in] riid

Tipo: REFIID

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

[out] ppv

Tipo: VOID**

O endereço do ponteiro para receber o ponteiro de interface solicitado. Se a chamada de função for bem-sucedida, ppvSite conterá o ponteiro de interface solicitado. Se nenhum site estiver disponível ou a interface solicitada não tiver suporte, ppvSite será definido como NULL e a função retornará um código de erro COM.

Retornar valor

Tipo: HRESULT

Retorna S_OK se o site foi recuperado com êxito ou um código de erro COM, caso contrário.

Comentários

Essa função chama o método QueryInterface do objeto especificado para obter a interface IObjectWithSite . Se tiver êxito, a função chamará o método IObjectWithSite::GetSite da interface para obter o site.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server, Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlwapi.h
DLL	Shlwapi.dll (versão 5.0 ou posterior)