source_block::reserve, méthode

Réserve un message précédemment offert par cet objet source_block.

virtual bool reserve(
   runtime_object_identity _MsgId,
   ITarget<_Target_type> * _PTarget
);

Paramètres

  • _MsgId
    runtime_object_identity de l'objet message transmis.

  • _PTarget
    Pointeur vers le bloc cible qui appelle la méthode reserve.

Valeur de retour

true si le message a été réservé avec succès ; sinon false. Les réservations peuvent échouer pour de nombreuses raisons, notamment : le message a déjà été réservé ou accepté par une autre cible, la source pourrait refuser des réservations, etc.

Notes

La méthode lève une exception invalid_argument si le paramètre _PTarget est NULL.

Une fois que vous avez appelé reserve, s'il réussit, vous devez appeler consume ou release pour accepter ou renoncer à la propriété d'un message, respectivement.

Configuration requise

En-tête : agents.h

Espace de noms d'accès : Concurrency

Voir aussi

Référence

source_block, classe