IOleObject::GetMoniker
.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 checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Thismethod recupera moniker de uma objeto incorporado, que o chamador pode utilizar para link para o objeto.
Syntax
HRESULT GetMoinker(
DWORD dwAssign,
DWORD dwWhichMoniker,
IMoniker** ppmk
);
Parameters
dwAssign
[no] Determina como o moniker é atribuído para o objeto. Depending on o valor de dwAssign, GetMoniker do seguinte:- Obtém uma moniker somente se um tiver sido atribuído
- Força atribuída de uma moniker, se necessário, para atender a chamar
- Obtém uma moniker temporário
Valores para dwAssign são especificadas na enumeração OLEGETMONIKER.
dwWhichMoniker
[no] Especifica a forma do moniker que está sendo solicitado.Os valores válidos são extraídos de enumeração OLEWHICHMK.
ppmk
[out] Endereço do IMonikervariável * pointer que recebe o ponteiro interface para moniker do objeto.Se ocorrer um erro *ppmk Deve ser definido como NULL.
Cada tempo um objeto recebe um chamar para GetMoniker, ele deve aumentar o contagem de referência em *ppmk.
O chamador é responsável para chamar IUnknown::Release Quando isso é feito com *ppmk.
Remarks
Não é possível transmitir OLEGETMONIKER_UNASSIGN quando chamado GetMoniker. Esse valor é válido somente quando chamado IOleClientSite::GetMoniker.
O GetMoniker método retorna moniker de um objeto. Como IOleObject::SetMoniker, esse método é importante apenas o contexto de gerenciar vínculos para incorporado objetos e até mesmo em que maiúsculas e minúsculas é opcional. Um cliente potencial link que requer moniker de um objeto para BIND para o objeto pode chamar este método para obter esse moniker.
A implementação usar como padrão de GetMoniker Chamadas de IOleClientSite::GetMoniker, retornando E_UNEXPECTED se o objeto não for execução ou não tenha um válido ponteiro para um site cliente.
Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.
Requirements
| Header | Oleidl.h, oleidl.idl |
| Library | oleaut32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
IOleObject
IOleClientSite::GetMoniker
IOleObject::SetMoniker
IMoniker
IUnknown::Release
OLEGETMONIKER
OLEWHICHMK