通过

IOleUIObjInfoA：：GetObjectInfo 方法 (oledlg.h)

  • 项目

获取对象的大小、类型、名称和位置信息。

语法

HRESULT GetObjectInfo(
  [in]            DWORD dwObject,
  [out]           DWORD *lpdwObjSize,
  [out, optional] LPSTR *lplpszLabel,
  [out, optional] LPSTR *lplpszType,
  [out, optional] LPSTR *lplpszShortType,
  [out, optional] LPSTR *lplpszLocation
);

参数

[in] dwObject

对象的唯一标识符。

[out] lpdwObjSize

指向磁盘上对象大小（以字节为单位）的指针。 这可能是一个近似值。

[out, optional] lplpszLabel

接收指向对象的标签字符串的指针的指针变量的地址。 此参数可以为 NULL ，表示实现不应返回标签字符串。

[out, optional] lplpszType

接收指向对象的长类型字符串的指针的指针变量的地址。 此参数可以为 NULL ，表示实现不应返回长类型字符串。

[out, optional] lplpszShortType

接收指向对象的短类型字符串的指针的指针变量的地址。 此参数可以为 NULL ，表示实现不应返回短类型字符串。

[out, optional] lplpszLocation

接收指向对象的源位置字符串的指针的指针变量的地址。 此参数可以为 NULL ，表示实现不应返回位置字符串。

返回值

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

返回代码 说明
E_FAIL
 此操作失败。
E_INVALIDARG
 指定的标识符无效。
E_OUTOFMEMORY
 此操作的可用内存不足。

注解

字符串和对象的大小显示在对象属性 “常规 ”页中。

实施者说明

GetObjectInfo 的实现应将对象的每个属性置于提供的 out 参数中。 当对象的大小未知时，将 lpdwObjSize 设置为 (DWORD) -1。 使用通过 CoGetMalloc 获取的 OLE 任务分配器 (其余) 参数分配所有字符串，分配所有字符串，对于具有 [out] 字符串参数的所有 OLE 接口来说都是标准，也可以直接使用 CoTaskMemAlloc。

要求

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

另请参阅

CoGetMalloc

CoTaskMemAlloc

IOleUIObjInfo