ILockBytes::Stat 方法 (objidl.h)

Stat 方法检索包含此字节数组对象信息的 STATSTG 结构。

语法

HRESULT Stat(
  [out] STATSTG *pstatstg,
  [in]  DWORD   grfStatFlag
);

parameters

[out] pstatstg

指向 STATSTG 结构的指针,此方法在其中放置有关此字节数组对象的信息。 如果发生错误,指针为 NULL

[in] grfStatFlag

指定此方法是否应通过从 STATFLAG 枚举获取的值提供 STATSTG 结构的 pwcsName 成员。 如果指定了STATFLAG_NONAME,则不会提供 STATSTGpwcsName 成员,从而节省内存分配操作。 另一个可能的值(STATFLAG_DEFAULT)指示提供 STATSTG 结构的所有成员。

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK 在指定位置成功返回 STATSTG 结构。
E_OUTOFMEMORY 由于结构中的名称成员内存不足,未返回 STATSTG 结构。
STG_E_ACCESSDENIED 未返回 STATSTG 结构,因为调用方无权访问字节数组。
STG_E_INSUFFICIENTMEMORY 由于内存不足,未返回 STATSTG 结构。
STG_E_INVALIDFLAG grfStateFlag 参数的值无效。
STG_E_INVALIDPOINTER pStatStg 参数的值无效。

注解

ILockBytes::Stat 应在 STATSTG 结构中提供有关字节数组对象的信息。

要求

   
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 objidl.h
Library Uuid.lib
DLL Ole32.dll

请参阅

ILockBytes - File-Based 实现

ILockBytes - 全局内存实现

STATFLAG

STATSTG