Condividi tramite


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

Vedi anche

RTM_DEST_INFO

RtmGetChangeStatus

RtmGetChangedDests

RtmIgnoreChangedDests

RtmIsMarkedForChangeNotification

RtmMarkDestForChangeNotification