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

Artigo
03/13/2024

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