IOleObject::GetMiscStatus 方法 (oleidl.h)

检索对象在创建和加载时的状态。

语法

HRESULT GetMiscStatus(
  [in]  DWORD dwAspect,
  [out] DWORD *pdwStatus
);

参数

[in] dwAspect

正在请求状态信息的 对象的方面。 该值是从枚举 DVASPECT 获取的。

[out] pdwStatus

一个指针,指向返回状态信息的位置。 此参数不能为 NULL

返回值

此方法在成功时返回S_OK。 其他可能的返回值包括以下内容。

返回代码 说明
OLE_S_USEREG
将其他状态信息的检索委托给此方法的默认处理程序实现。
CO_E_CLASSNOTREG
没有为 对象注册 CLSID。
CO_E_READREGDB
访问注册表时出错。

注解

容器在创建或加载对象时通常会调用 IOleObject::GetMiscStatus ,以确定如何显示对象以及它支持的行为类型。

对象将状态信息存储在注册表中。 如果对象未运行,则默认处理程序的 IOleObject::GetMiscStatus 实现将从注册表中检索此信息。 如果对象正在运行,则默认处理程序在对象本身上调用 IOleObject::GetMiscStatus

注册表中实际存储的信息因各个对象而异。 要返回的状态值在枚举 OLEMISC 中定义。

如果未找到与指定 DVASPECT 对应的子项,则使用 IOleObject::GetMiscStatus 的默认值。 若要设置 OLE 控件,请指定 DVASPECT==1。 这将导致注册表中出现以下情况:

HKEY_CLASSES_ROOT\CLSID\ . . .
   MiscStatus = 1

实施者说明

实现通常包括委托对默认处理程序的调用。

要求

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

另请参阅

DVASPECT

FORMATETC

IOleObject

OLEMISC