Fonction RtmGetRoutePointer (rtmv2.h)

La fonction RtmGetRoutePointer obtient un pointeur direct vers un itinéraire qui permet au propriétaire de l’itinéraire d’accéder en lecture.

Syntaxe

DWORD RtmGetRoutePointer(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_ROUTE_HANDLE  RouteHandle,
  [out] PRTM_ROUTE_INFO   *RoutePointer
);

[in] RtmRegHandle

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

[in] RouteHandle

Handle vers l’itinéraire.

[out] RoutePointer

Lors de l’entrée, RoutePointer est un pointeur vers NULL.

À la sortie, RoutePointer reçoit un pointeur vers l’itinéraire.

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_ACCESS_DENIED	Le client appelant n’est pas propriétaire de cet itinéraire.
ERROR_INVALID_HANDLE	Le handle n'est pas valide.

Le pointeur retourné pointe vers la partie publique de l’itinéraire.

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