IOleObject：：GetMoniker 方法 (oleidl.h)

项目
03/04/2024

检索嵌入对象的名字对象，调用方可以使用该名字对象链接到该对象。

语法

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

参数

[in] dwAssign

确定如何将名字对象分配给该对象。根据 dwAssign 的值， IOleObject：：GetMoniker 将执行以下操作之一：

仅当已分配一个名字对象时，才获取名字对象。
如有必要，强制分配名字对象以满足调用。
获取临时名字对象。

dwAssign 的值在枚举 OLEGETMONIKER 中指定。

注意调用 IOleObject：：GetMoniker 时，无法传递 OLEGETMONIKER_UNASSIGN。此值仅在调用 IOleObject：：GetMoniker 时有效。

[in] dwWhichMoniker

指定所请求的名字对象的形式。可能的值取自枚举 OLEWHICHMK。

[out] ppmk

接收指向对象名字对象的接口指针的 IMoniker 指针变量的地址。如果发生错误， 必须将 ppmk 设置为 NULL。每次对象收到对 IOleObject：：GetMoniker 的调用时，它都必须增加 ppmk 上的引用计数。调用方负责在使用 ppmk 时调用 Release。

返回值

此方法在成功时返回S_OK。

注解

IOleObject：：GetMoniker 方法返回对象的名字对象。与 IOleObject：：SetMoniker 一样，此方法仅在管理指向嵌入对象的链接的上下文中很重要，在这种情况下，此方法也是可选的。要求对象的名字对象绑定到对象的潜在链接客户端可以调用此方法以获取该名字对象。 IOleObject：：GetMoniker 的默认实现调用 IOleClientSite：：GetMoniker，如果对象未运行或没有指向客户端站点的有效指针，则返回E_UNEXPECTED。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	oleidl.h