hivex_value_utf8


Description:

[ Version ( deprecated = true , since = "1.19.35" ) ]
public string hivex_value_utf8 (int64 valueh) throws Error

Warning: hivex_value_utf8 is deprecated.

return the data field as a UTF-8 string

Note:

In new code, use hivex_value_string instead

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