Metodo source_block::reserve

Consente di riservare un messaggio messo a disposizione in precedenza da tale oggetto source_block.

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

Parametri

  • _MsgId
    runtime_object_identity dell'oggetto message proposto.

  • _PTarget
    Puntatore al blocco di destinazione che sta chiamando il metodo reserve.

Valore restituito

true se il messaggio è stato riservato, false in caso contrario.Le prenotazioni possono avere esito negativo per numerose cause, tra cui: il messaggio è già riservato o accettato da un altro database di destinazione, l'origine potrebbe negare le prenotazioni, e così via.

Note

Il metodo genera un'eccezione invalid_argument se il parametro _PTarget è NULL.

Dopo la chiamata di reserve, se l'esito è positivo, è necessario chiamare consume o release per assumere o rilasciare rispettivamente il possesso del messaggio.

Requisiti

Header: agents.h

Concorrenza diSpazio dei nomi:

Vedere anche

Riferimenti

Classe source_block