FwpmTransactionBegin0 函数 （fwpmk.h）
FwpmTransactionBegin0 函数在当前会话中开始显式事务。
语法
NTSTATUS FwpmTransactionBegin0(
[in] HANDLE engineHandle,
[in] UINT32 flags
);
参数
[in] engineHandle
筛选引擎打开的会话句柄。 调用 FwpmEngineOpen0 以打开筛选器引擎的会话。
[in] flags
可能的值：
| 事务标志 | 意义 |
|---|---|
| 0 | 开始读/写事务。 |
| FWPM_TXN_READ_ONLY | 开始只读事务。 |
返回值
| 返回代码/值 | 描述 |
|---|---|
|
ERROR_SUCCESS 0 |
事务已成功启动。 |
|
FWP_E_* 错误代码 0x80320001 — 0x80320039 |
Windows 筛选平台（WFP）特定错误。 有关详细信息，请参阅 WFP 错误代码。 |
|
RPC_* 错误代码 0x80010001 — 0x80010122 |
无法与远程或本地防火墙引擎通信。 |
| 其他 NTSTATUS 代码 | 发生错误。 |
言论
不能从事务内部调用此函数。 它将失败，FWP_E_TXN_IN_PROGRESS。 有关事务的详细信息，请参阅 对象管理。
对于只读事务，调用方需要 FWPM_ACTRL_BEGIN_READ_TXN 对筛选器引擎的访问权限。 对于读/写事务，调用方需要 FWPM_ACTRL_BEGIN_WRITE_TXN 对筛选器引擎的访问权限。 有关详细信息，请参阅 访问控制。
FwpmTransactionBegin0 是 FwpmTransactionBegin的特定实现。 有关详细信息，请参阅 WFP Version-Independent 名称和面向特定版本的 Windows。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 从 Windows Vista 开始可用。 |
| 目标平台 | 普遍 |
| 标头 | fwpmk.h |
| 库 | fwpkclnt.lib |
| IRQL | <= PASSIVE_LEVEL |