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

Artículo
03/15/2023

Recupera el moniker de un objeto incrustado, que el autor de la llamada puede usar para vincular al objeto .

Sintaxis

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

Parámetros

[in] dwAssign

Determina cómo se asigna el moniker al objeto. Según el valor de dwAssign, IOleObject::GetMoniker realiza una de las siguientes acciones:

Obtiene un moniker solo si ya se ha asignado uno.
Fuerza la asignación de un moniker, si es necesario, para satisfacer la llamada.
Obtiene un moniker temporal.

Los valores de dwAssign se especifican en la enumeración OLEGETMONIKER.

Nota No se puede pasar OLEGETMONIKER_UNASSIGN al llamar a IOleObject::GetMoniker. Este valor solo es válido cuando se llama a IOleObject::GetMoniker.

[in] dwWhichMoniker

Especifica la forma del moniker que se va a solicitar. Los valores posibles se toman de la enumeración OLEWHICHMK.

[out] ppmk

Dirección de la variable de puntero IMoniker que recibe el puntero de interfaz al moniker del objeto. Si se produce un error, ppmk debe establecerse en NULL. Cada vez que un objeto recibe una llamada a IOleObject::GetMoniker, debe aumentar el recuento de referencias en ppmk. Es responsabilidad del autor de la llamada llamar a Release cuando se hace con ppmk.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente.

Comentarios

El método IOleObject::GetMoniker devuelve el moniker de un objeto. Al igual que IOleObject::SetMoniker, este método solo es importante en el contexto de administrar vínculos a objetos incrustados e incluso en ese caso es opcional. Un cliente de vínculo potencial que requiere el moniker de un objeto para enlazar con el objeto puede llamar a este método para obtener ese moniker. La implementación predeterminada de IOleObject::GetMoniker llama a IOleClientSite::GetMoniker, devolviendo E_UNEXPECTED si el objeto no se está ejecutando o no tiene un puntero válido a un sitio cliente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	oleidl.h