Compartilhar via


Método IOleObject::GetMoniker (oleidl.h)

Recupera o moniker de um objeto inserido, que o chamador pode usar para vincular ao objeto .

Sintaxe

HRESULT GetMoniker(
  [in]  DWORD    dwAssign,
  [in]  DWORD    dwWhichMoniker,
  [out] IMoniker **ppmk
);

Parâmetros

[in] dwAssign

Determina como o moniker é atribuído ao objeto . Dependendo do valor de dwAssign, IOleObject::GetMoniker faz um dos seguintes procedimentos:

  • Obtém um moniker somente se um já tiver sido atribuído.
  • Força a atribuição de um moniker, se necessário, para atender à chamada.
  • Obtém um moniker temporário.
Os valores de dwAssign são especificados na enumeração OLEGETMONIKER.
Nota Você não pode passar OLEGETMONIKER_UNASSIGN ao chamar IOleObject::GetMoniker. Esse valor só é válido ao chamar IOleObject::GetMoniker.
 

[in] dwWhichMoniker

Especifica a forma do moniker que está sendo solicitado. Os valores possíveis são obtidos da enumeração OLEWHICHMK.

[out] ppmk

Endereço da variável de ponteiro IMoniker que recebe o ponteiro de interface para o moniker do objeto. Se ocorrer um erro, ppmk deverá ser definido como NULL. Sempre que um objeto recebe uma chamada para IOleObject::GetMoniker, ele deve aumentar a contagem de referência em ppmk. É responsabilidade do chamador chamar Release quando terminar com ppmk.

Retornar valor

Esse método retorna S_OK com êxito.

Comentários

O método IOleObject::GetMoniker retorna o moniker de um objeto. Assim como IOleObject::SetMoniker, esse método é importante apenas no contexto de gerenciamento de links para objetos inseridos e, mesmo nesse caso, é opcional. Um cliente de link potencial que exige que o moniker de um objeto seja associado ao objeto pode chamar esse método para obter esse moniker. A implementação padrão de IOleObject::GetMoniker chama iOleClientSite::GetMoniker, retornando E_UNEXPECTED se o objeto não estiver em execução ou não tiver um ponteiro válido para um site cliente.

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 oleidl.h

Confira também

CreateItemMoniker

IOleClientSite::GetMoniker

Ioleobject

IOleObject::SetMoniker

OLEGETMONIKER

OLEWHICHMK