LPM_DeleteState函式 (lpmapi.h)

PCM 會呼叫 LPM_DeleteState 函式，以刪除 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