Función RtmReleaseDests (rtmv2.h)
La función RtmReleaseDests libera los identificadores de destino.
Sintaxis
DWORD RtmReleaseDests(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] UINT NumDests,
[in] PRTM_DEST_INFO DestInfos
);
Parámetros
[in] RtmRegHandle
Identificador para el cliente obtenido de una llamada anterior a RtmRegisterEntity.
[in] NumDests
Especifica el número de destinos en DestInfos.
[in] DestInfos
Puntero a una matriz de estructuras de RTM_DEST_INFO que se van a liberar. Los destinos se obtuvieron de una llamada anterior a RtmGetEnumDests.
Valor devuelto
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 |
|---|---|
|
El identificador no es válido. |
Comentarios
No use esta función para liberar RTM_DEST_INFO estructuras obtenidas de una llamada a RtmGetChangedDests. En su lugar, use RtmReleaseChangedDests .
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 DestInfos que se va a asignar antes de llamar a esta función.
Requisitos
| 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 |