Función RtmReferenceHandles (rtmv2.h)

Artículo
03/05/2024

La función RtmReferenceHandles aumenta el recuento de referencias de los objetos a los que apunta uno o varios identificadores que el administrador de enrutamiento usó para acceder a esos objetos. Un cliente debe usar esta función cuando el cliente debe mantener un identificador, pero liberar el resto de la estructura de información asociada al identificador.

Sintaxis

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

Parámetros

[in] RtmRegHandle

Identificador del cliente obtenido de una llamada anterior a RtmRegisterEntity.

[in] NumHandles

Especifica el número de identificadores en RtmHandles.

[in] RtmHandles

Matriz de identificadores para la que aumentar el recuento de referencias.

Valor devuelto

Si la función se realiza 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_INVALID_HANDLE	El identificador no es válido.

Comentarios

Un cliente siempre debe llamar a esta función al almacenar en caché un identificador devuelto por el administrador de tablas de enrutamiento. Esto notifica al administrador de tablas de enrutamiento que no debe destruir el objeto al que hace referencia el identificador hasta que el cliente libere el identificador.

Cuando un cliente debe liberar el identificador, el cliente debe llamar a la función de versión adecuada, en función del tipo de identificador. Por ejemplo, para liberar una ruta, llame a RtmReleaseRoutes.

Requisitos

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