Funzione RtmReleaseChangedDests (rtmv2.h)
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 |
---|---|
|
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 |