IOleUIObjInfoW::GetObjectInfo 方法 (oledlg.h)
获取对象的大小、类型、名称和位置信息。
语法
HRESULT GetObjectInfo(
[in] DWORD dwObject,
[out] DWORD *lpdwObjSize,
[out, optional] LPWSTR *lplpszLabel,
[out, optional] LPWSTR *lplpszType,
[out, optional] LPWSTR *lplpszShortType,
[out, optional] LPWSTR *lplpszLocation
);
参数
[in] dwObject
对象的唯一标识符。
[out] lpdwObjSize
指向磁盘上对象大小(以字节为单位)的指针。 这可能是一个近似值。
[out, optional] lplpszLabel
接收指向对象的标签字符串的指针的指针变量的地址。 此参数可以为 NULL ,表示实现不应返回标签字符串。
[out, optional] lplpszType
接收指向对象的长类型字符串的指针的指针变量的地址。 此参数可以为 NULL ,表示实现不应返回长类型字符串。
[out, optional] lplpszShortType
接收指向对象的短类型字符串的指针的指针变量的地址。 此参数可以为 NULL ,表示实现不应返回短类型字符串。
[out, optional] lplpszLocation
接收指向对象的源位置字符串的指针的指针变量的地址。 此参数可以为 NULL ,表示实现不应返回位置字符串。
返回值
此方法在成功时返回S_OK。 其他可能的返回值包括以下内容。
返回代码 | 说明 |
---|---|
|
此操作失败。 |
|
指定的标识符无效。 |
|
此操作的可用内存不足。 |
注解
字符串和对象的大小显示在对象属性 “常规 ”页中。
实施者说明
GetObjectInfo 的实现应将对象的每个属性置于提供的 out 参数中。 当对象的大小未知时,将 lpdwObjSize 设置为 (DWORD) -1。 使用通过 CoGetMalloc 获取的 OLE 任务分配器 (其余) 参数分配所有字符串,分配所有字符串,对于具有 [out] 字符串参数的所有 OLE 接口来说都是标准,也可以直接使用 CoTaskMemAlloc。要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | oledlg.h |