Função RtmReferenceHandles (rtmv2.h)

Artigo
03/01/2024

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.

Valor	Significado
ERROR_INVALID_HANDLE	O manipulador é inválido.

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

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	rtmv2.h
Biblioteca	Rtm.lib
DLL	Rtm.dll