IOleObject::SetMoniker

9/8/2008

Thismethod notifica um objeto de um do seguinte:

• Moniker do seu contêiner
• O moniker do próprio objeto relativo para o contêiner
• Moniker completo do objeto a

Syntax

HRESUTL SetMoniker( 
  DWORD dwWhichMoniker, 
  IMoniker* pmk
);

Parameters

• dwWhichMoniker
  [no] Especifica qual moniker é passado PMK.

  Os valores são a partir de enumeração OLEWHICHMK.

• PMK
  [no] Ponteiro para onde retornar o moniker.

Return Value

Este método oferece suporte a padrão valor de retorno E_FAIL, as well as S_OK, que indica que o moniker definidas com êxito.

Remarks

Um contêiner que ofereça suporte a links para incorporado objetos devem ser capazes informar um objeto incorporado quando seu moniker é alterado. Caso contrário, subseqüentes tentativas por clientes link para BIND para falhas de objeto. O SetMoniker método fornece uma maneira para um contêiner para se comunicar este informações.

O contêiner pode transmitir uma do seguinte:

• Seu próprio moniker
• Moniker relativo de um objeto para o contêiner
• Moniker completo de um objeto

Na prática, se um contêiner passa nada Other Than moniker completo de um objeto, cada objeto chama o contêiner voltar a solicitação atribuída do moniker completo, que o objeto necessita para registrar próprio na execução objeto tabela.

O moniker de um objeto relativo a seu contêiner é armazenado pelo manipulador de objeto como parte estado persistente do objeto de. No entanto, o moniker de contêiner do objeto deve não ser persistentemente armazenada dentro de objeto porque o contêiner pode ser renomeado como a qualquer momento.

Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.

Notas para chamadores

Chama um contêiner SetMoniker Quando o contêiner é renomeada e incorporado do contêiner Objetos atualmente ou possivelmente servir como fontes link.

Chamar recipientes SetMoniker principalmente no contexto de vinculação, pois um objeto incorporado já está ciente dos seu moniker. Mesmo no contexto de vinculação, chamado esse método é opcional, pois os objetos podem chamar IOleClientSite::GetMoniker Para forçar atribuída de uma nova moniker.

Observação Para Implementers

Ao receber um chamar para SetMoniker, um objeto deve registrar seu moniker completo na execução objeto tabela e enviar OnRename notificação para informar todos os recpetores que existem para o objeto.

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
OLEWHICHMK

Concepts

Determining Supported COM APIs