FwpmProviderContextGetByKey1 函数 （fwpmk.h）
FwpmProviderContextGetByKey1 函数检索提供程序上下文。
语法
NTSTATUS FwpmProviderContextGetByKey1(
[in] HANDLE engineHandle,
const GUID *key,
FWPM_PROVIDER_CONTEXT1 **providerContext
);
参数
[in] engineHandle
筛选引擎打开的会话句柄。 调用 FwpmEngineOpen0 以打开筛选器引擎的会话。
key
指向唯一标识提供程序上下文的 GUID 的指针。 这是指向此对象的应用程序调用 FwpmProviderContextAdd1 时指定的同一 GUID 的指针。
providerContext
提供程序上下文信息。
返回值
| 返回代码/值 | 描述 |
|---|---|
|
ERROR_SUCCESS 0 |
已成功检索提供程序上下文。 |
|
FWP_E_* 错误代码 0x80320001 — 0x80320039 |
Windows 筛选平台（WFP）特定错误。 有关详细信息，请参阅 WFP 错误代码。 |
|
RPC_* 错误代码 0x80010001 — 0x80010122 |
无法与远程或本地防火墙引擎通信。 |
| 其他 NTSTATUS 代码 | 发生错误。 |
言论
调用方必须通过调用 FwpmFreeMemory0释放返回的对象。
调用方需要 FWPM_ACTRL_READ 访问提供程序上下文。 有关详细信息，请参阅 访问控制。
FwpmProviderContextGetByKey0 是 FwpmProviderContextGetByKey的特定实现。 有关详细信息，请参阅 WFP Version-Independent 名称和面向特定版本的 Windows。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 从 Windows Vista 开始可用。 |
| 目标平台 | 普遍 |
| 标头 | fwpmk.h |
| 库 | fwpkclnt.lib |
| IRQL | <= PASSIVE_LEVEL |
另请参阅
下面是当前文档中的所有链接：