Struct ParentLocator 

pub struct ParentLocator<'a> { /* private fields */ }

Parent Locator metadata item for differencing disks.

Layout: 20-byte header + N × 12-byte key-value entry table + key/value data.

Implementations

impl<'a> ParentLocator<'a>

pub fn header(&self) -> LocatorHeader<'a>

Access the 20-byte locator header.

pub fn entry(&self, index: usize) -> Result<KeyValueEntry<'a>>

Get a key-value entry by index.

Errors

Returns an error if the index is out of range or entry bytes are truncated.

pub fn entries(&self) -> impl Iterator<Item = KeyValueEntry<'a>> + 'a

Iterate over all key-value entries (zero-copy).

pub fn key_value_data(&self) -> &'a [u8]

The raw parent locator item data (including the 20-byte header and entry table).

Offsets in KeyValueEntry are relative to the start of this data.

pub fn resolve_parent_path(&self) -> Result<PathBuf>

Resolve the preferred parent path candidate.

Path candidates are selected in VHDX order: relative_path, then volume_path, then absolute_win32_path. Key and value strings are decoded from the parent locator’s UTF-16LE key-value data.

Errors

Returns an error if a key or value cannot be decoded, or if none of the standard parent path keys is present.