Función RtmReleaseChangedDests (rtmv2.h)

Artículo
03/13/2024

La función RtmReleaseChangedDests libera los identificadores de destino modificados.

Sintaxis

DWORD RtmReleaseChangedDests(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] RTM_NOTIFY_HANDLE NotifyHandle,
  [in] UINT              NumDests,
  [in] PRTM_DEST_INFO    ChangedDests
);

Parámetros

[in] RtmRegHandle

Identificador del cliente obtenido de una llamada anterior a RtmRegisterEntity.

[in] NotifyHandle

Identificador de una notificación de cambio, obtenida de una llamada anterior a RtmRegisterForChangeNotification.

[in] NumDests

Especifica el número de destinos en ChangedDests.

[in] ChangedDests

Puntero a una matriz de estructuras de RTM_DEST_INFO que se van a liberar. Los destinos modificados se obtuvieron de una llamada anterior a RtmGetChangedDests.

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

Use siempre esta función para liberar las estructuras de RTM_DEST_INFO modificadas obtenidas de una llamada a RtmGetChangedDests.

La estructura RTM_DEST_INFO es una estructura de tamaño variable. Si un destino contiene información para más de una vista, el tamaño de RTM_DEST_INFO aumenta para cada vista. Use la macro RTM_SIZE_OF_DEST_INFO para determinar el tamaño de un búfer ChangedDests que se va a asignar antes de llamar a esta función.

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