Funzione RtmReleaseDests (rtmv2.h)

Articolo
08/25/2023

La funzione RtmReleaseDests rilascia gli handle di destinazione.

Sintassi

DWORD RtmReleaseDests(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] UINT              NumDests,
  [in] PRTM_DEST_INFO    DestInfos
);

Parametri

[in] RtmRegHandle

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

[in] NumDests

Specifica il numero di destinazioni in DestInfos.

[in] DestInfos

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

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

Non usare questa funzione per rilasciare RTM_DEST_INFO strutture ottenute da una chiamata a RtmGetChangedDests. Usare invece RtmReleaseChangedDests .

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 DestInfos da allocare prima di chiamare questa funzione.

Requisiti


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

Condividi tramite