Fonction RtmBlockMethods (rtmv2.h)

Article
03/01/2024

La fonction RtmBlockMethods bloque ou débloque l’exécution des méthodes pour une destination, un itinéraire ou un tronçon suivant spécifié, ou pour tous les destinations, itinéraires et tronçons suivants.

Syntaxe

DWORD RtmBlockMethods(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] HANDLE            TargetHandle,
  [in] UCHAR             TargetType,
  [in] DWORD             BlockingFlag
);

Paramètres

[in] RtmRegHandle

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

[in] TargetHandle

Gérez vers une destination, un itinéraire ou un tronçon suivant pour lequel bloquer les méthodes. Ce paramètre est facultatif et peut être défini sur NULL pour bloquer les méthodes pour toutes les cibles.

[in] TargetType

Spécifie le type du handle dans TargetHandle. Ce paramètre est facultatif et peut être défini sur NULL pour bloquer les méthodes pour toutes les cibles. Les indicateurs suivants sont utilisés.

Type	Signification
DEST_TYPE	TargetHandle est une destination.
NEXTHOP_TYPE	TargetHandle est un tronçon suivant.
ROUTE_TYPE	TargetHandle est un itinéraire.

[in] BlockingFlag

Spécifie s’il faut bloquer ou débloquer des méthodes. Les indicateurs suivants sont utilisés.

Constant	Signification
RTM_BLOCK_METHODS	Méthodes de bloc pour la cible spécifiée.
RTM_RESUME_METHODS	Débloquez les méthodes pour la cible spécifiée.

Valeur retournée

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

Si la fonction échoue, la valeur de retour est le code d’erreur suivant.

Valeur	Signification
ERROR_INVALID_HANDLE	Le handle n'est pas valide.

Remarques

Actuellement, cette fonction ne prend pas en charge les méthodes de blocage pour une destination, un itinéraire ou un tronçon suivant spécifique.

Les méthodes sont généralement bloquées lorsque des données spécifiques au client dans la route sont modifiées ; un client bloque les méthodes, réorganise les données, puis débloque les méthodes.

Les clients ne doivent bloquer les méthodes que pendant une courte période. Si un deuxième client appelle RtmInvokeMethod et que les méthodes du premier client sont bloquées, RtmInvokeMethod ne retourne pas les méthodes tant que les méthodes ne sont pas débloquées et que l’appel de fonction n’est pas terminé.

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

RtmGetEntityMethods

RtmInvokeMethod

Partager via