IByteBuffer::Commit 方法

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

Commit 方法可确保对在事务处理模式下打开的对象所做的任何更改都反映在父存储中。

语法

HRESULT Commit(
  [in] LONG grfCommitFlags
);

parameters

grfCommitFlags [in]

控制提交对流对象的更改的方式。 有关这些值的定义,请参阅 STGC 枚举。

返回值

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

备注

此方法可确保在事务处理模式下打开的流对象的更改反映在父存储中。 自流打开或上次提交以来对流所做的更改将反映到父存储对象。 如果在事务处理模式下打开父级,则父级以后仍可能还原回滚对此流对象的更改。 复合文件实现不支持在事务处理模式下打开流,因此此方法除了刷新内存缓冲区外,效果很小。

示例

以下示例演示如何将更改提交到存储。

HRESULT  hr;

// Commit the buffer.
hr = pIByteBuff->Commit(STGC_DEFAULT | STGC_CONSOLIDATE);
if (FAILED(hr))
  printf("Failed IByteBuffer::Commit\n");

要求

要求
最低受支持的客户端
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