Volume.getActivationRoot

Gets the activation root for a #GVolume if it is known ahead of mount time. Returns null otherwise. If not null and if volume is mounted, then the result of [gio.mount.Mount.getRoot] on the #GMount object obtained from [gio.volume.Volume.getMount] will always either be equal or a prefix of what this function returns. In other words, in code

GMount *mount;
 GFile *mount_root
 GFile *volume_activation_root;

 mount = g_volume_get_mount (volume); // mounted, so never NULL
 mount_root = g_mount_get_root (mount);
 volume_activation_root = g_volume_get_activation_root (volume); // assume not NULL

then the expression

(g_file_has_prefix (volume_activation_root, mount_root) ||
  g_file_equal (volume_activation_root, mount_root))

will always be true.

Activation roots are typically used in #GVolumeMonitor implementations to find the underlying mount to shadow, see [gio.mount.Mount.isShadowed] for more details.

Returns

the activation root of volume

or null. Use [gobject.object.ObjectWrap.unref] to free.