LPM_DeleteState 函数 (lpmapi.h)

项目
02/28/2024

LPM_DELETESTATE函数由 PCM 调用，以删除 LPM 的 RSVP 状态信息。 RSVP 状态在各种情况下被删除，包括当 SBM 收到 RSVP TEAR/ERR 消息时，或者当 RSVP 状态超时时。 LPM_DeleteState 函数调用是同步的。 PCM 不期望 LPM 对此请求产生任何结果。

语法

void LPM_DeleteState(
  [in] RSVP_HOP     *pRcvdIfAddr,
  [in] MSG_TYPE     RsvpMsgType,
  [in] RSVP_SESSION *pRsvpSession,
  [in] RSVP_HOP     *pRsvpFromHop,
  [in] RESV_STYLE   *pResvStyle,
  [in] int          FilterSpecCount,
  [in] FILTER_SPEC  **ppFilterSpecList,
  [in] int          TearDownReason
);

参数

[in] pRcvdIfAddr

指向接收 RSVP TEAR 消息的接口的指针。接收的接口 IP 地址作为 RSVP HOP 对象提供，逻辑接口句柄设置为 SNMP 索引。如果 PCM 出于 RSVP TEAR 消息以外的任何原因调用 LPM_DeleteState 函数，则此参数可以为 null。请注意，由于 Windows 2000 的即插即用功能，接口索引号可能会随着接口的添加和删除而更改。

[in] RsvpMsgType

LPM 应删除其状态的 RSVP 消息类型。

[in] pRsvpSession

指向 LPM 应删除其状态的 RSVP 会话对象的指针。此值决不能为 null。

[in] pRsvpFromHop

指向 RSVP HOP 对象的指针，该对象标识发送 TEAR 消息的节点。 LPM 可以使用此参数来查找状态信息。

[in] pResvStyle

指向参数的指针，该参数指定 RSVP RESV_TEAR消息的 RSVP 预留样式。 LPM 可以使用此参数来查找状态信息。

[in] FilterSpecCount

指定 FilterSpecList 中的 FilterSpecs 数。对于 RESV 消息， FilterSpecCount 依赖于 RsvpStyle。对于 PATH 消息，此值始终为 1。

[in] ppFilterSpecList

FilterSpec 指针的数组。请注意， FilterSpecList 的内容依赖于 RsvpStyle;如果 RsvpMsgType 为RSVP_PATH则 FilterSpecList 指定 SenderTemplate，如果 RsvpMsgType 为RSVP_RESV则 FilterSpecList 是需要删除 RESV 状态的筛选器列表。

[in] TearDownReason

删除状态的原因。可能的值为：

RCVD_PATH_TEAR

RCVD_RESV_TEAR

ADM_CTRL_FAILED

STATE_TIMEOUT

FLOW_DURATION

LPM 可以使用 DeleteReason 进行统计收集或任何其他用途。

返回值

无

备注

PCM 将为每个 LPM 调用 LPM_DeleteState 函数;LPM 应准备好处理不存在状态 的LPM_DeleteState ，如 cbAdmitResult 函数的备注部分所述。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	lpmapi.h

另请参阅

cbAdmitResult

通过