IOleClientSite::GetMoniker

9/8/2008

Este método solicita moniker de um objeto.

Syntax

HRESULT GetMoniker( 
  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.

  Não é possível transmitir OLEGETMONIKER_UNASSIGN quando chamado IOleObject::GetMoniker. Esse valor é válido somente quando chamado IOleClientSite::GetMoniker.

• 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.

  É responsabilidade do chamador para chamar Release quando ele é feito com *ppmk.

Return Value

Este método oferece suporte a padrão os valores de retorno E_FAIL e E_UNEXPECTED, bem como os valores a seguinte tabela.

Valor	Descrição
S_OK	Solicitada moniker retornado com êxito.
E_NOTIMPL	Neste contêiner não pode atribuir monikers aos objetos. Essa é a maiúsculas e minúsculas com recipientes OLE 1.

Remarks

O IOleObject::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 IOleObject::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

IOleClientSite
IMoniker
IOleObject::GetMoniker
IOleObject::SetMoniker
OLEGETMONIKER
OLEWHICHMK

Concepts

Determining Supported COM APIs