Fonction RtmReferenceHandles (rtmv2.h)

Article
03/04/2024

La fonction RtmReferenceHandles augmente le nombre de références pour les objets pointés par un ou plusieurs handles que le gestionnaire de routage a utilisés pour accéder à ces objets. Un client doit utiliser cette fonction quand il doit conserver un handle, mais libérer le reste de la structure d’informations associée au handle.

Syntaxe

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

Paramètres

[in] RtmRegHandle

Gérez le client obtenu à partir d’un appel précédent à RtmRegisterEntity.

[in] NumHandles

Spécifie le nombre de handles dans RtmHandles.

[in] RtmHandles

Tableau de handles pour lequel augmenter le nombre de références.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Valeur	Signification
ERROR_INVALID_HANDLE	Le handle n'est pas valide.

Remarques

Un client doit toujours appeler cette fonction lors de la mise en cache d’un handle retourné par le gestionnaire de table de routage. Cela avertit le gestionnaire de table de routage qu’il ne doit pas détruire l’objet auquel le handle fait référence tant que le handle n’est pas libéré par le client.

Lorsqu’un client doit libérer le handle, il doit appeler la fonction de mise en production appropriée, en fonction du type de handle. Par exemple, pour libérer un itinéraire, appelez RtmReleaseRoutes.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	rtmv2.h
Bibliothèque	Rtm.lib
DLL	Rtm.dll