IkeextSaGetById0 函数 (fwpmu.h)
IkeextSaGetById0 函数从数据库中检索 IKE/AuthIP 安全关联 (SA) 。
注意IkeextSaGetById0 是 Windows Vista 中使用的 IkeextSaGetById 的特定实现。 有关详细信息 ，请参阅 WFP Version-Independent 名称和面向 Windows 的特定版本 。 对于 Windows 7，IkeextSaGetById1 可用。 对于Windows 8，可以使用 IkeextSaGetById2。
语法
DWORD IkeextSaGetById0(
[in] HANDLE engineHandle,
[in] UINT64 id,
[out] IKEEXT_SA_DETAILS0 **sa
);
参数
[in] engineHandle
类型： 句柄
筛选器引擎的打开会话的句柄。 调用 FwpmEngineOpen0 以打开与筛选器引擎的会话。
[in] id
类型： UINT64
SA 标识符。
[out] sa
类型： IKEEXT_SA_DETAILS0**
SA 详细信息的地址。
返回值
类型：DWORD
| 返回代码/值 | 说明 |
|---|---|
|
已成功检索 SA。 |
|
Windows 筛选平台 (WFP) 特定错误。 有关详细信息 ，请参阅 WFP 错误代码 。 |
|
无法与远程或本地防火墙引擎通信。 |
注解
调用方必须通过调用 FwpmFreeMemory0 释放 sa。
调用方需要 FWPM_ACTRL_READ 访问 IKE/AuthIP 安全关联数据库。 有关详细信息，请参阅访问控制。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | fwpmu.h |
| Library | Fwpuclnt.lib |
| DLL | Fwpuclnt.dll |