#[non_exhaustive]pub struct NetworkRefreshResult {
pub snapshot: NetworkSnapshot,
pub sampled_reachability: NetworkStatus,
pub sample_id: u64,
pub sample_started_at: SystemTime,
pub sampled_at: SystemTime,
pub network_name_source: NetworkNameSource,
pub network_name_diagnostics: Vec<NetError>,
pub ip_stack_source: NetworkIpStackSource,
}Expand description
A completed Windows sampling window and the associated client snapshot.
refresh freshly queries reachability and network name;
refresh_reachability queries only reachability and preserves the cached
name, identified by NetworkNameSource::CachedObservation. The IP-stack
field retains the latest background interface observation. These system calls
form a sampling window, not an atomic Windows snapshot. A successful query
with unchanged values preserves the snapshot’s revision and observed_at.
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.snapshot: NetworkSnapshotThis client’s latest snapshot after committing the sample. Each field
retains its newest observation: a full query whose name was slow may
preserve reachability from a later reachability-only query. Compare
sampled_reachability for this sampling window’s own system result.
sampled_reachability: NetworkStatusReachability returned by this sampling window’s own Windows query.
snapshot.reachability may already contain a newer observation.
sample_id: u64Increasing sampling-start identifier within this OpenNet engine. Results may complete out of order; failed/cancelled samples may leave gaps. This is not a snapshot or event revision.
sample_started_at: SystemTimeWall-clock time immediately before this round’s system queries.
sampled_at: SystemTimeWall-clock time immediately after the queries. Clock corrections can move wall time backwards; use sample_id for ordering.
network_name_source: NetworkNameSourceSource of the network name, including a successful absence or a cached value which was not queried by this sample.
network_name_diagnostics: Vec<NetError>Query faults bypassed by a successful fresh NLM name fallback.
ip_stack_source: NetworkIpStackSourceExplicitly identifies the IP-stack field as a background observation.