Funzione RtmGetChangedDests (rtmv2.h)

Articolo
03/01/2024

La funzione RtmGetChangedDests restituisce un set di destinazioni con informazioni modificate.

Sintassi

DWORD RtmGetChangedDests(
  [in]      RTM_ENTITY_HANDLE RtmRegHandle,
  [in]      RTM_NOTIFY_HANDLE NotifyHandle,
  [in, out] PUINT             NumDests,
  [out]     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, out] NumDests

In input NumDests è un puntatore a un valore UINT che specifica il numero massimo di destinazioni che possono essere ricevute da ChangedDests.

Nell'output NumDests riceve il numero effettivo di destinazioni ricevute da ChangedDests.

[out] ChangedDests

In input, ChangedDests è un puntatore a una matrice di strutture RTM_DEST_INFO .

Nell'output, ChangedDests viene riempito con le informazioni di destinazione modificate.

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_PARAMETER	Un parametro contiene informazioni non corrette.
ERROR_NO_MORE_ITEMS	Non sono più state modificate le destinazioni da recuperare.

Commenti

Un client riceve una notifica delle modifiche da un RTM_EVENT_CALLBACK. Il RTM_EVENT_CALLBACK viene usato solo per notificare al client, non recapitare le modifiche. Dopo la ricezione di una notifica di modifica, il client deve chiamare ripetutamente RtmGetChangedDests per recuperare tutte le modifiche.

Se due o più modifiche alla stessa destinazione si sono verificate dopo la notifica, viene restituita solo la modifica più recente.

Quando un client non richiede più gli handle in ChangedDests, il client deve usare RtmReleaseChangedDests per rilasciare gli handle.

Per il codice di esempio che usa questa funzione, vedere Usare il callback di notifica eventi.

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