Fonction RtmReleaseDests (rtmv2.h)

Article
08/25/2023

La fonction RtmReleaseDests libère les handles de destination.

Syntaxe

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

Paramètres

[in] RtmRegHandle

Gérez le client obtenu à partir d’un appel précédent à RtmRegisterEntity.

[in] NumDests

Spécifie le nombre de destinations dans DestInfos.

[in] DestInfos

Pointeur vers un tableau de structures RTM_DEST_INFO à libérer. Les destinations ont été obtenues à partir d’un appel précédent à RtmGetEnumDests.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Valeur	Signification
ERROR_INVALID_HANDLE	Le handle n'est pas valide.

Notes

N’utilisez pas cette fonction pour libérer RTM_DEST_INFO structures obtenues à partir d’un appel à RtmGetChangedDests. Utilisez Plutôt RtmReleaseChangedDests .

La structure RTM_DEST_INFO est une structure de taille variable. Si une destination contient des informations pour plusieurs vues, la taille de RTM_DEST_INFO augmente pour chaque vue. Utilisez la macro RTM_SIZE_OF_DEST_INFO pour déterminer la taille d’une mémoire tampon DestInfos à allouer avant d’appeler cette fonction.

Spécifications


Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	rtmv2.h
Bibliothèque	Rtm.lib
DLL	Rtm.dll

Voir aussi

Partager via