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 |
标头 |
|
类型库 |
|
DLL |
|
IID |
IID_IByteBuffer定义为 E126F8FE-A7AF-11D0-B88A-00C04FD424B9 |
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈