Funzione RtmReleaseChangedDests (rtmv2.h)

Articolo
03/01/2024

La funzione RtmReleaseChangedDests rilascia gli handle di destinazione modificati.

Sintassi

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

Parametri

[in] RtmRegHandle

Handle per il client ottenuto da una chiamata precedente a RtmRegisterEntity.

[in] NotifyHandle

Gestire una notifica di modifica, ottenuta da una chiamata precedente a RtmRegisterForChangeNotification.

[in] NumDests

Specifica il numero di destinazioni in ChangedDests.

[in] ChangedDests

Puntatore a una matrice di strutture RTM_DEST_INFO da rilasciare. Le destinazioni modificate sono state ottenute da una chiamata precedente a RtmGetChangedDests.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_INVALID_HANDLE	Handle non valido.

Commenti

Usare sempre questa funzione per rilasciare le strutture modificate RTM_DEST_INFO ottenute da una chiamata a RtmGetChangedDests.

La struttura RTM_DEST_INFO è una struttura di dimensioni variabili. Se una destinazione contiene informazioni per più visualizzazioni, le dimensioni di RTM_DEST_INFO aumentano per ogni visualizzazione. Utilizzare la macro RTM_SIZE_OF_DEST_INFO per determinare la dimensione di un buffer ChangedDests da allocare prima di chiamare questa funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	rtmv2.h
Libreria	Rtm.lib
DLL	Rtm.dll