Função RtmReferenceHandles (rtmv2.h)

A função RtmReferenceHandles aumenta a contagem de referência para objetos apontados por um ou mais identificadores que o gerenciador de roteamento usou para acessar esses objetos. Um cliente deve usar essa função quando o cliente deve manter um identificador, mas liberar o restante da estrutura de informações associada ao identificador.

Sintaxe

DWORD RtmReferenceHandles(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] UINT              NumHandles,
  [in] HANDLE            *RtmHandles
);

Parâmetros

[in] RtmRegHandle

Manipule para o cliente obtido de uma chamada anterior para RtmRegisterEntity.

[in] NumHandles

Especifica o número de identificadores em RtmHandles.

[in] RtmHandles

Matriz de identificadores para o qual aumentar a contagem de referência.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos seguintes códigos de erro.

Comentários

Um cliente deve sempre chamar essa função ao armazenar em cache um identificador retornado pelo gerenciador de tabelas de roteamento. Isso notifica o gerenciador de tabelas de roteamento de que ele não deve destruir o objeto ao qual o identificador se refere até que o identificador seja liberado pelo cliente.

Quando um cliente deve liberar o identificador, o cliente deve chamar a função de versão apropriada, com base no tipo de identificador. Por exemplo, para liberar uma rota, chame RtmReleaseRoutes.

Requisitos

Confira também

RtmDeleteEnumHandle

RtmReleaseChangedDests

RtmReleaseDestInfo

RtmReleaseEntityInfo

RtmReleaseNextHopInfo

RtmReleaseRouteInfo