LPM_Initialize 函数 (lpmapi.h)
LPM_Initialize 函数 (LPM) 初始化本地策略模块。 当允许控制服务需要执行基于策略的允许控制时,例如当 SBM 成为指定子网带宽管理器 (DSBM) 时,就会发生这种情况。 在返回之前,LPM 应同步初始化自身。
语法
ULONG LPM_Initialize(
[in] LPM_HANDLE LpmHandle,
[in] LPM_INIT_INFO *pLpmInitInfo,
[out] DWORD *pLpmVersionNumber,
[out] PETYPE *pSupportedPeType,
[out] VOID *Reserved
);
parameters
[in] LpmHandle
由 PCM 分配的 LPM 的唯一句柄。
[in] pLpmInitInfo
指向包含 LPM 初始化信息的LPM_INIT_INFO结构的指针。
[out] pLpmVersionNumber
正在请求的 LPM 版本。
[out] pSupportedPeType
有效的策略元素 (PE) 类型,LPM 使用该元素做出基于策略的允许控制决策。 每个 LPM 只能支持一种 PE 类型,但将来的版本可能允许 LPM 支持多个 PE 类型。 保留的 PE 类型在 Lpmapi.h 中定义。 有关策略元素类型的详细信息,请参阅 策略元素。
单个 DLL 可以通过在 PCM 配置数据中多次输入 DLL 名称来支持多个 PE 类型。 在这种情况下,PCM 将多次加载并调用同一个LPM_Initialize例程:LPM 负责为这些附加调用返回不同的 PE 类型。
LPM 可以返回一种特殊的 PE 类型(LPM_ALL_PE_TYPES),以指示它将基于所有策略数据对象做出基于策略的允许控制决策。 在这种情况下,PCM 将假定此 LPM 了解如何为 PCM 无法理解的传出消息生成策略数据对象。
[out] Reserved
保留供将来使用。
返回值
如果成功初始化 LPM,并在 pSupportedPeType 中返回有效的 PE 类型,则返回值将LPM_OK。 PCM 将除 LPM_OK 以外的任何值视为错误,并卸载 DLL (LPM 始终作为 DLL) 实现。 如果返回除 LPM_OK 以外的值或 pSupportedPeType 无效,则 PCM 会将记录写入事件日志,并包含 DLL 的名称和返回的错误值。
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | lpmapi.h |