Module instance_handle 

InstanceHandle — opaker, lokaler Identifier fuer Entities und Sample-Instanzen (DDS DCPS 1.4 §2.3.3 IDL-PSM, §2.2.2.5.1 SampleInfo.instance_handle).

In der Spec ist InstanceHandle_t ein Builtin-Type ohne fixe Wire-Form — er wird nie auf den Wire gestellt, sondern dient ausschliesslich der lokalen Identifikation (z.B. um in DataReader::read_instance() einen Sample-Stream zu adressieren). Die Spec stellt nur sicher, dass HANDLE_NIL einen reservierten “kein Handle”-Wert hat.

Wir kodieren ihn als opake u64:

• Eindeutig pro Entity / Sample-Instanz innerhalb einer Runtime.
• HANDLE_NIL = 0 (Spec-Konvention).
• Erzeugung via InstanceHandleAllocator mit monoton steigendem Counter — keine Wiederverwendung gedroppter Handles.

Structs

InstanceHandle

Opaker InstanceHandle_t (DDS-DCPS 1.4 §2.3.3).

InstanceHandleAllocator

Atomarer Counter zur Vergabe eindeutiger InstanceHandle-Werte.

Constants

HANDLE_NIL

Spec-Alias fuer den NIL-Handle (DDS-DCPS 1.4 §2.3.3).