IByteBuffer::Stat 方法

[ Stat 方法可用于“要求”部分中指定的操作系统。 它不适用于 Windows Server 2003 Service Pack 1 (SP1) 及更高版本、Windows Vista、Windows Server 2008 和操作系统的后续版本。 IStream 接口提供类似的功能。]

Stat 方法从流对象中检索统计信息。

语法

HRESULT Stat(
  [out] LPSTATSTRUCT pstatstg,
  [in]  LONG         grfStatFlag
);

parameters

pstatstg [out]

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

grfStatFlag [in]

指定此方法不返回 STATSTRUCT 结构中的某些字段,从而节省内存分配操作。 值取自 STATFLAG 枚举

返回值

返回值为 HRESULT。 值 S_OK 表示调用成功。

备注

IByteBuffer::Stat 方法检索指向 STATSTRUCT 结构的指针,该结构包含有关此打开的流的信息。

示例

以下示例演示如何从流中检索统计信息。

STATSTRUCT  statstr;
HRESULT     hr;

// Retrieve the statistical information.
hr = pIByteBuff->Stat(&statstr,
                      STATFLAG_DEFAULT);
if (FAILED(hr))
  printf("Failed IByteBuffer::Stat\n");
else
  // Use statstr as needed.

要求

要求
最低受支持的客户端
Windows XP [仅限桌面应用]
最低受支持的服务器
Windows Server 2003 [仅限桌面应用]
终止客户端支持
Windows XP
终止服务器支持
Windows Server 2003
标头
Scardssp.h
类型库
Scardssp.tlb
DLL
Scardssp.dll
IID
IID_IByteBuffer定义为 E126F8FE-A7AF-11D0-B88A-00C04FD424B9