Gio.Volume.prototype.get_activation_root
function get_activation_root(): Gio.File {
// Gjs wrapper for g_volume_get_activation_root()
}
Gets the activation root for a Gio.Volume 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.prototype.get_root on the Gio.Mount object obtained from Gio.Volume.prototype.get_mount will always either be equal or a prefix of what this function returns. In other words, in code
|[<!-- language="C" --> 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 |[<!-- language="C" --> (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 Gio.VolumeMonitor implementations to find the underlying mount to shadow, see Gio.Mount.prototype.is_shadowed for more details.
Since 2.18
- Returns
the activation root of volume or null. Use GObject.Object.prototype.unref to free.