função LPM_DeleteState (lpmapi.h)

A função LPM_DeleteState é chamada pelo PCM para excluir as informações de estado RSVP dos LPMs. Os estados RSVP são excluídos em várias ocasiões, incluindo quando o SBM recebe mensagens RSVP TEAR/ERR ou quando um estado RSVP atinge o tempo limite. A chamada de função LPM_DeleteState é síncrona. O PCM não espera nenhum resultado do LPM para essa solicitação.

Sintaxe

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
);

Parâmetros

[in] pRcvdIfAddr

Ponteiro para a interface na qual a mensagem TEAR RSVP foi recebida. O endereço IP da interface recebida é fornecido como o objeto RSVP HOP e o Identificador de Interface Lógica é definido como o Índice SNMP. Se o PCM estiver chamando a função LPM_DeleteState por qualquer motivo diferente de uma mensagem TEAR RSVP, esse parâmetro poderá ser nulo. Observe que os números de índice de interface podem ser alterados com a adição e exclusão de interfaces, devido aos Plug and Play recursos do Windows 2000.

[in] RsvpMsgType

Tipo de mensagem RSVP para o qual o LPM deve excluir seu estado.

[in] pRsvpSession

Ponteiro para o objeto de sessão RSVP para o qual o LPM deve excluir seu estado. Esse valor nunca é null.

[in] pRsvpFromHop

Ponteiro para um objeto RSVP HOP que identifica o nó que enviou a mensagem TEAR. Os LPMs podem usar esse parâmetro para localizar informações de estado.

[in] pResvStyle

Ponteiro para um argumento que especifica o estilo de reserva RSVP para mensagens de RESV_TEAR RSVP. Os LPMs podem usar esse parâmetro para localizar informações de estado.

[in] FilterSpecCount

Especifica o número de FilterSpecs em FilterSpecList. Para mensagens RESV, FilterSpecCount depende de RsvpStyle. Para mensagens PATH, esse valor sempre será 1.

[in] ppFilterSpecList

Matriz de ponteiros FilterSpec. Observe que o conteúdo de FilterSpecList depende de RsvpStyle; se RsvpMsgType for RSVP_PATH FilterSpecList especificar o SenderTemplate, se RsvpMsgType for RSVP_RESV FilterSpecList será a lista de filtros para os quais o estado RESV precisa ser excluído.

[in] TearDownReason

Motivo para excluir o estado. Os valores possíveis são:

RCVD_PATH_TEAR

RCVD_RESV_TEAR

ADM_CTRL_FAILED

STATE_TIMEOUT

FLOW_DURATION

Os LPMs podem usar DeleteReason para coleta estatística ou qualquer outro uso.

Retornar valor

Nenhum

Comentários

O PCM chamará a função LPM_DeleteState para cada LPM; Os LPMs devem estar preparados para lidar com LPM_DeleteState para um estado inexistente, conforme descrito na seção Comentários da função cbAdmitResult .

Requisitos

Confira também

cbAdmitResult