CBADMITRESULT 回调函数 (lpmapi.h)
cbAdmitResult 函数由 LPM 用于返回LPM_AdmitRsvpMsg请求的结果。 仅当 LPM 已返回LPM_RESULT_DEFER LPM_AdmitRsvpMsg函数调用 时,才应使用此函数。 PCM 仅在每个 LPM 通过 LPM_Initialize 函数的 ResultTimeLimit 参数建立的结果时间限制内接受此函数的结果。
语法
CBADMITRESULT Cbadmitresult;
ULONG * Cbadmitresult(
[in] LPM_HANDLE LpmHandle,
[in] RHANDLE RequestHandle,
[in] ULONG ulPcmActionFlags,
[in] int LpmError,
[in] int PolicyDecisionsCount,
[in] POLICY_DECISION *pPolicyDecisions
)
{...}
参数
[in] LpmHandle
LPM 的唯一句柄,如 LPM_Initialize 中提供。 PCM 将忽略未附带有效 LPM 句柄的任何结果。
[in] RequestHandle
将此请求与所有其他请求区分开来的唯一句柄。 当通过调用 cbAdmitResult 为单个请求异步返回结果时,LPM 必须将此句柄传递给 PCM。 返回结果后 ,RequestHandle 参数将变为无效,要求每个请求从 PCM 获取其自己的唯一 RequestHandle 。
[in] ulPcmActionFlags
策略控制模块操作标志。
[in] LpmError
LPM 错误代码。 必须是下列选项之一:
值 | 含义 |
---|---|
|
提供的 LPM 句柄无效。 |
|
LPM 在时间限制后返回了结果。 |
|
提供的请求句柄无效。 |
|
LPM 已返回此请求的结果。 |
|
提供的结果无效。 |
[in] PolicyDecisionsCount
pPolicyDecisions 中提供的策略决策数。
[in] pPolicyDecisions
策略决策,形式为一个或多个 POLICY_DECISION 结构。
返回值
此回调函数不返回值。
注解
当请求被拒绝时,PCM 将调用 LPM 以指示它删除请求的状态。 LPM 可以选择在拒绝过程中随时删除请求的状态。 如果 LPM 在拒绝请求后不久删除了请求的状态,则 LPM 必须准备好处理 PCM (后续调用,方法是通过 LPM_DeleteState 函数) 删除 () 状态。
LPM 不需要维护LPV_DONT_CARE返回的请求的状态。 但是,LPM 必须准备好处理此 (不存在) 状态的LPM_DeleteState请求。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | lpmapi.h |