2.2.2.1.4.1 Additional Flags
Additional Flags has the following format.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Additional_Flags_Header |
|||||||||||||||||||||||||||||||
|
A |
B |
C |
D |
E |
F |
Reserved |
Reserved (variable) |
||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
Additional Flags Header (4 bytes): A 32-bit Stream Object Header (section 2.2.1.5.2) that specifies the start of an Additional Flags structure.
A – Return Applied Storage Index Id Entries (1 bit): A bit that specifies that the Storage Indexes that are applied to the storage as part of the Put Changes will be returned in a Storage Index specified in the Put Changes response by the Applied Storage Index Id (section 2.2.3.1.3).
B – Return Data Elements Added (1 bit): A bit that specifies that the data elements that are added to the storage as part of this Put Changes will be returned in a data element collection specified in the Put Changes response by the Data Elements Added collection (section 2.2.3.1.3)<23>. This flag MAY be set.
C – Check for Id Reuse (1 bit): A bit that specifies that the server will attempt to check the Put Changes request for the re-use of previously used IDs. This might occur when ID allocations are used, and a client rollback occurs.
D – Coherency Check Only Applied Index Entries (1 bit): A bit that specifies that only the index entries that are actually applied as part of the change will be checked for coherency.
E – Full File Replace Put (1 bit): A bit that specifies that the Put Changes request will be treated as a full file save with no dependencies on any pre-existing state.<24> This flag MAY be set. This flag is not required for a full file save, but if specified, the server MAY bypass checks that would otherwise be unnecessary.
F – Require Storage Mappings Rooted (1 bit): A bit that specifies that the Put Changes request will fail coherency if any of the supplied Storage Indexes are unrooted.
Reserved (10 bits): A 10-bit reserved field that MUST be set to zero and MUST be ignored.
Reserved (variable): A compact unsigned 64-bit integer (section 2.2.1.1) that MUST be ignored.