hivex_value_string

return the data field as a UTF-8 string

This calls hivex_value_value (which returns the data field from a hivex value tuple). It then assumes that the field is a UTF-16LE string and converts the result to UTF-8 (or if this is not possible, it returns an error).

This is useful for reading strings out of the Windows registry. However it is not foolproof because the registry is not strongly-typed and fields can contain arbitrary or unexpected data.

This function depends on the feature "hivex". See also feature_available.

Parameters:

this	A GuestfsSession object

Returns:

the returned string, or NULL on error