Crate winres_edit

This crate allows you to load and modify Windows resources inside of .exe and .res files. This crate currently does not support actual resource data destructuring with exception of Version Strings (VS_VERSIONINFO), which is useful to modify application manifests. Loaded resources are available as raw Vec<u8> data, useful to modify bitmaps and icons.

Please note that all operations performed on the opened resource file are accumulated and are then “flushed” to the file when the file is closed using the close() function. This is due to the behavior of the underlying Win32 API (UpdateResource) functionality used by this crate.

Example

Load and update a resource

let mut resources = Resources::new(&Path::new("myfile.exe"));
resources.load().expect("Unable to load resources");
resources.open().expect("Unable to open resource file for updates");

resources.find(resource_type::ICON,Id::Integer(1))
    .expect("unable to find main icon")
    .replace(icon_data)?
    .update()?;

let version: [u16;4] = [0,1,0,0];
resources.get_version_info()?.expect("Unable to get version info")
    .set_file_version(&version)
    .set_product_version(&version)
    .insert_strings(
        &[
            ("ProductName","My Product")
            ("FileDescription","My File")
        ]
    )
    .remove_string("SomeExistingString")
    .update()?;

resources.close();

Create a new resource

let res = Resource::new(
    &resources,
    resource_type::ICON.into(),
    Id::Integer(14).into(),
    1033,
    target_icon.data(),
);
res.update()?;

Modules

• resource_type
  List of resource constants representing Windows resource types expressed as Id

Macros

• pcstr
  Convert a string to a zero-terminated windows::core::PCSTR string.

Structs

• Date
  Date helper used for serializing and deserializing 2 LE-encoded u32 values into a single u64 value.
• FileInfo
  Rust representation of VS_FIXEDFILEINFO structure.
• Header
  Helper representing structure data header used in VS_VERSIONINFO and all related data structures.
• Resource
  Structure representing a single resource
• ResourceDataInner
  Placeholder for future data serialization (not implementated)
• Resources
  Data structure representing a resource file. This data structure points to a .res or .exe file and allows loading and modifying resource in this file.
• Version
  Windows Version value represented as [u16;4] array. This version struct is helpful for serialization and deserialization of the versions packed into a u64 value represented as 2 LE-encoded u32 (DWORD) values.
• VersionInfo
  VS_VERSIONINFO resource structure representation.

Enums

• Data
  Wrapper of the underlying data that may be represented as a binary buffer or a text string.
• DataType
  Data type flag indicating if data is encoded as a binary or a text string.
• Error
  Errors produced by this crate.
• Id
  Id enum that contains a windows resource id representation. Windows resource ids can be a pointer to a string or if the pointer value is below 0xffff the id represents an integer resource id. Id encapsulates this representation into a Rust enum and provides From and Into trait implementations to interop with the Windows API.
• ResourceData
  Placeholder for future data serialization (not implementated)
• VersionInfoChild
  Helper enum for serializing and deserializing StringFileInfo and VarFileInfo child structures.