Función RtmGetRoutePointer (rtmv2.h)

La función RtmGetRoutePointer obtiene un puntero directo a una ruta que permite al propietario del acceso de lectura de ruta.

Sintaxis

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

[in] RtmRegHandle

Identificador para el cliente obtenido de una llamada anterior a RtmRegisterEntity.

[in] RouteHandle

Identificador de la ruta.

[out] RoutePointer

En la entrada, RoutePointer es un puntero a NULL.

En la salida, RoutePointer recibe un puntero a la ruta.

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Valor	Significado
ERROR_ACCESS_DENIED	El cliente que realiza la llamada no posee esta ruta.
ERROR_INVALID_HANDLE	El identificador no es válido.

El puntero que se devolvió apunta a la parte pública de la ruta.

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	rtmv2.h
Library	Rtm.lib
Archivo DLL	Rtm.dll