source_block::reserve-Methode

Reserviert eine Meldung, die zuvor von diesem source_block-Objekt angeboten wurde.

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

Parameter

• _MsgId
  Die runtime_object_identity des angebotenen message-Objekts.

• _PTarget
  Ein Zeiger für den Zielblock, der die reserve-Methode aufruft.

Rückgabewert

true, wenn die Nachricht erfolgreich reserviert wurde, andernfalls false. Reservierungen können aus vielen Gründen fehlschlagen, einschließlich: die Meldung war bereits von einem anderen Ziel reserviert oder akzeptiert, die Quelle konnte Reservierungen verweigern usw.

Hinweise

Die Methode löst eine invalid_argument-Ausnahme aus, wenn der Parameter _PTarget NULL ist.

Nachdem Sie reserve erfolgreich aufgerufen haben, müssen Sie consume oder release aufrufen, um den Besitz der Meldung zu übernehmen oder abzugeben.

Anforderungen

Header: agents.h

Namespace: Concurrency

Siehe auch

Referenz

source_block-Klasse