Fonction RtmGetEntityMethods (rtmv2.h)

Article
03/04/2024

La fonction RtmGetEntityMethods interroge le client spécifié pour déterminer les méthodes disponibles pour qu’un autre client soit appelé.

Syntaxe

DWORD RtmGetEntityMethods(
  [in]      RTM_ENTITY_HANDLE         RtmRegHandle,
  [in]      RTM_ENTITY_HANDLE         EntityHandle,
  [in, out] PUINT                     NumMethods,
  [out]     PRTM_ENTITY_EXPORT_METHOD ExptMethods
);

Paramètres

[in] RtmRegHandle

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

[in] EntityHandle

Gérez le client pour lequel obtenir des méthodes.

[in, out] NumMethods

Lors de l’entrée, NumMethods spécifie un pointeur valide vers une valeur UINT . Spécifiez zéro pour renvoyer le nombre de méthodes disponibles à exporter.

À la sortie, NumMethods reçoit le nombre de méthodes exportées par le client.

[out] ExptMethods

Reçoit un pointeur vers une structure RTM_ENTITY_EXPORT_METHOD qui contient l’ensemble d’identificateurs de méthode demandés par le client appelant.

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_INSUFFICIENT_BUFFER	La mémoire tampon fournie n’est pas assez grande pour contenir toutes les informations demandées.

Remarques

N’appelez pas directement la méthode d’un autre client. Utilisez toujours RtmInvokeMethod. Le gestionnaire de tables de routage vérifie les erreurs lors de l’utilisation de RtmInvokeMethod pour s’assurer que le client n’est pas désinscrit ou déjà désinscrit.

Si ERROR_INSUFFICIENT_BUFFER est retourné, il peut y avoir des données dans ExptMethods ; NumMethods spécifie le nombre de méthodes réellement adaptées à la mémoire tampon.

Lorsque le handle d’entité n’est plus nécessaire, libérez-le en appelant RtmReleaseEntities.

Pour obtenir un exemple de code utilisant cette fonction, consultez Obtenir et appeler les méthodes exportées pour un client.

Configuration requise

Condition requise	Valeur
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

RtmBlockMethods

RtmInvokeMethod

Partager via