IObjectWithSite::GetSite
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
9/9/2008
O GetSite método recupera o último site definido com IObjectWithSite::SetSite.
Syntax
HRESULT GetSite (
REFIID riid,
void ** ppvSite
);
Parameters
- riid
[no] Especifica a interface você desejar usar. Este é o identificador interface (IID) do ponteiro de interface retornado na variável de membro ppvSite.
- ppvSite
[out] O endereço da variável de ponteiro que recebe o ponteiro interface retornados em riid. Em caso de sucesso, *ppvSite Contém o ponteiro interface solicitada para o último site que foi definido com o método IObjectWithSite::SetSite. A interface específica que é retornado depende de riid argumento. Isso torna riid e ppvSite executar as mesmas funções como aqueles no Windows Embedded CE IUnknown::QueryInterfacemétodo. Se o apropriado ponteiro interface estiver disponível, o objeto deve chamar o Windows Embedded CE IUnknown::AddRef método nesse ponteiro antes de retornar. Se nenhum site está disponível ou se a interface solicitada não é com suporte, GetSite Deve CAST *ppvSite Para NULL e retornar um apropriado código de erro.
Return Value
- S_OK
Indica que GetSite conseguiu retornar com êxito um site previamente definido com IObjectWithSite::SetSite. Você deve chamar IUnknown::Release Quando o site não é mais necessária.
- E_FAIL
Não há nenhum site, e *ppvSite Contém NULL.
- E_NOINTERFACE
Há um site, mas ele não tem suporte a interface solicitada na variável de membro riid.
Requirements
| Header | ocidl.h |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Pocket PC 2000 and later, Smartphone 2002 and later |
See Also
Reference
IContextMenu
IObjectWithSite
IObjectWithSite::SetSite