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
ERROR_INVALID_HANDLE	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

Consulte también

RTM_DEST_INFO

RtmCreateDestEnum

RtmDeleteEnumHandle

RtmGetEnumDests