X-Git-Url: https://wimlib.net/git/?p=wimlib;a=blobdiff_plain;f=include%2Fwimlib.h;h=e9fb0b761ba55c3105be3caae29c3b3e03d323e0;hp=46c5bc0fdd0e94aa6893a8359faabb76c0bb2919;hb=065b2b3513da8692efab0cd5344c054f246fa635;hpb=b418fde525bd458518b88d88122556ce458c94a3;ds=sidebyside

diff --git a/include/wimlib.h b/include/wimlib.h
index 46c5bc0f..e9fb0b76 100644
--- a/include/wimlib.h
+++ b/include/wimlib.h
@@ -11,7 +11,7 @@
 /**
  * @mainpage
  *
- * This is the documentation for the library interface of wimlib 1.8.1, a C
+ * This is the documentation for the library interface of wimlib 1.8.2, a C
  * library for creating, modifying, extracting, and mounting files in the
  * Windows Imaging Format.  This documentation is intended for developers only.
  * If you have installed wimlib and want to know how to use the @b wimlib-imagex
@@ -259,8 +259,9 @@
  *
  * wimlib_update_image() can add, delete, and rename files in a WIM image.
  *
- * wimlib_set_image_name(), wimlib_set_image_descripton(), and
- * wimlib_set_image_flags() can change other image metadata.
+ * wimlib_set_image_name(), wimlib_set_image_descripton(),
+ * wimlib_set_image_flags(), and wimlib_set_image_property() can change other
+ * image metadata.
  *
  * wimlib_set_wim_info() can change information about the WIM file itself, such
  * as the boot index.
@@ -379,7 +380,7 @@
 #define WIMLIB_MINOR_VERSION 8
 
 /** Patch version of the library (for example, the 5 in 1.2.5). */
-#define WIMLIB_PATCH_VERSION 1
+#define WIMLIB_PATCH_VERSION 2
 
 #ifdef __cplusplus
 extern "C" {
@@ -2432,7 +2433,6 @@ enum wimlib_error_code {
 	WIMLIB_ERR_INVALID_UTF8_STRING                = 31,
 	WIMLIB_ERR_IS_DIRECTORY                       = 32,
 	WIMLIB_ERR_IS_SPLIT_WIM                       = 33,
-	WIMLIB_ERR_LIBXML_UTF16_HANDLER_NOT_AVAILABLE = 34,
 	WIMLIB_ERR_LINK                               = 35,
 	WIMLIB_ERR_METADATA_NOT_FOUND                 = 36,
 	WIMLIB_ERR_MKDIR                              = 37,
@@ -2479,6 +2479,7 @@ enum wimlib_error_code {
 	WIMLIB_ERR_NOT_PERMITTED_TO_UNMOUNT           = 81,
 	WIMLIB_ERR_FVE_LOCKED_VOLUME		      = 82,
 	WIMLIB_ERR_UNABLE_TO_READ_CAPTURE_CONFIG      = 83,
+	WIMLIB_ERR_WIM_IS_INCOMPLETE		      = 84,
 };
 
 
@@ -3133,6 +3134,33 @@ wimlib_get_image_description(const WIMStruct *wim, int image);
 extern const wimlib_tchar *
 wimlib_get_image_name(const WIMStruct *wim, int image);
 
+/**
+ * @ingroup G_wim_information
+ *
+ * Get a per-image property from the WIM's XML document.  This is an alternative
+ * to wimlib_get_image_name() and wimlib_get_image_descripton() which allows
+ * getting any simple string property.
+ *
+ * @param wim
+ *	Pointer to the ::WIMStruct for the WIM.
+ * @param image
+ *	The 1-based index of the image for which to get the property.
+ * @param property_name
+ *	The name of the image property, for example "NAME", "DESCRIPTION", or
+ *	"TOTALBYTES".  The name can contain forward slashes to indicate a nested
+ *	XML element; for example, "WINDOWS/VERSION/BUILD" indicates the BUILD
+ *	element nested within the VERSION element nested within the WINDOWS
+ *	element.  The <tt>[</tt> character is reserved for future use.
+ *
+ * @return
+ *	The property's value as a wimlib_tchar string, or @c NULL if there is no
+ *	such property.  The string may not remain valid after later library
+ *	calls, so the caller should duplicate it if needed.
+ */
+extern const wimlib_tchar *
+wimlib_get_image_property(const WIMStruct *wim, int image,
+			  const wimlib_tchar *property_name);
+
 /**
  * @ingroup G_general
  *
@@ -3526,6 +3554,9 @@ wimlib_mount_image(WIMStruct *wim,
  * @retval ::WIMLIB_ERR_WIM_IS_ENCRYPTED
  *	The WIM cannot be opened because it contains encrypted segments.  (It
  *	may be a Windows 8 "ESD" file.)
+ * @retval ::WIMLIB_ERR_WIM_IS_INCOMPLETE
+ *	The WIM file is not complete (e.g. the program which wrote it was
+ *	terminated before it finished)
  * @retval ::WIMLIB_ERR_WIM_IS_READONLY
  *	::WIMLIB_OPEN_FLAG_WRITE_ACCESS was specified but the WIM file was
  *	considered read-only because of any of the reasons mentioned in the
@@ -3960,6 +3991,37 @@ wimlib_set_image_flags(WIMStruct *wim, int image, const wimlib_tchar *flags);
 extern int
 wimlib_set_image_name(WIMStruct *wim, int image, const wimlib_tchar *name);
 
+/**
+ * @ingroup G_modifying_wims
+ *
+ * Add, modify, or remove a per-image property from the WIM's XML document.
+ * This is an alternative to wimlib_set_image_name(),
+ * wimlib_set_image_descripton(), and wimlib_set_image_flags() which allows
+ * manipulating any simple string property.
+ *
+ * @param wim
+ *	Pointer to the ::WIMStruct for the WIM.
+ * @param image
+ *	The 1-based index of the image for which to set the property.
+ * @param property_name
+ *	The name of the image property in the same format documented for
+ *	wimlib_get_image_property().
+ * @param property_value
+ *	If not NULL and not empty, the property is set to this value.
+ *	Otherwise, the property is removed from the XML document.
+ *
+ * @return 0 on success; a ::wimlib_error_code value on failure.
+ *
+ * @retval ::WIMLIB_ERR_INVALID_IMAGE
+ *	@p image does not exist in @p wim.
+ * @retval ::WIMLIB_ERR_INVALID_PARAM
+ *	@p property_name has an unsupported format.
+ */
+extern int
+wimlib_set_image_property(WIMStruct *wim, int image,
+			  const wimlib_tchar *property_name,
+			  const wimlib_tchar *property_value);
+
 /**
  * @ingroup G_general
  *