Changeset 39877 in vbox for trunk/include/iprt

Timestamp:

Jan 25, 2012 4:26:55 PM (13 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

75918

Message:

IPRT: Implemented RTStrConvertHexBytes; Added RTManifestEntryQueryAttr and RTManifestQueryAttr.

Location:

trunk/include/iprt

Files:

• err.h (modified) (2 diffs)
• mangling.h (modified) (2 diffs)
• manifest.h (modified) (3 diffs)

trunk/include/iprt/err.h

@@ -866 +866 @@
 /** An unexpected (/unknown) exception was caught. */
 #define VERR_UNEXPECTED_EXCEPTION           (-22400)
+/** Buffer underflow. */
+#define VERR_BUFFER_UNDERFLOW               (-22401)
+/** Buffer underflow. */
+#define VINF_BUFFER_UNDERFLOW               22401
+/** Uneven input.  */
+#define VERR_UNEVEN_INPUT                   (-22402)
 /** @} */
 
@@ -1559 +1565 @@
 /** The file list doesn't match to the content of the manifest file. */
 #define VERR_MANIFEST_FILE_MISMATCH             (-903)
+/** The specified attribute (name) was not found in the manifest.  */
+#define VERR_MANIFEST_ATTR_NOT_FOUND            (-904)
+/** The attribute type did not match. */
+#define VERR_MANIFEST_ATTR_TYPE_MISMATCH        (-905)
+/** No attribute of the specified types was found. */
+#define VERR_MANIFEST_ATTR_TYPE_NOT_FOUND        (-906)
 /** @} */
 

trunk/include/iprt/mangling.h

@@ -715 +715 @@
 # define RTManifestEntryExists                          RT_MANGLER(RTManifestEntryExists)
 # define RTManifestEntryRemove                          RT_MANGLER(RTManifestEntryRemove)
+# define RTManifestEntryQueryAttr                       RT_MANGLER(RTManifestEntryQueryAttr)
 # define RTManifestEntrySetAttr                         RT_MANGLER(RTManifestEntrySetAttr)
 # define RTManifestEntryUnsetAttr                       RT_MANGLER(RTManifestEntryUnsetAttr)
@@ -720 +721 @@
 # define RTManifestEqualsEx                             RT_MANGLER(RTManifestEqualsEx)
 # define RTManifestPtIosAddEntryNow                     RT_MANGLER(RTManifestPtIosAddEntryNow)
+# define RTManifestQueryAttr                            RT_MANGLER(RTManifestQueryAttr)
 # define RTManifestReadStandard                         RT_MANGLER(RTManifestReadStandard)
 # define RTManifestReadStandardEx                       RT_MANGLER(RTManifestReadStandardEx)

trunk/include/iprt/manifest.h

@@ -54 +54 @@
 /** The end of the valid values. */
 #define RTMANIFEST_ATTR_END         RT_BIT_32(5)
+/** Wildcard for use in queries. */
+#define RTMANIFEST_ATTR_ANY         UINT32_C(0xffffffff)
 /** @} */
 
@@ -162 +164 @@
 
 /**
+ * Query a manifest entry attribute.
+ *
+ * @returns IPRT status code.
+ * @retval  VERR_BUFFER_OVERFLOW if the value buffer is too small. The @a
+ *          pszValue buffer will not be modified.
+ * @retval  VERR_MANIFEST_ATTR_NOT_FOUND
+ * @retval  VERR_MANIFEST_ATTR_TYPE_NOT_FOUND
+ * @retval  VERR_MANIFEST_ATTR_TYPE_MISMATCH
+ *
+ * @param   hManifest           The manifest handle.
+ * @param   pszEntry            The entry name.
+ * @param   pszAttr             The attribute name.  If NULL, it will be
+ *                              selected by @a fType alone.
+ * @param   fType               The attribute types the entry should match. Pass
+ *                              Pass RTMANIFEST_ATTR_ANY match any.  If more
+ *                              than one is given, the first matching one is
+ *                              returned.
+ * @param   pszValue            Where to return value.
+ * @param   cbValue             The size of the buffer @a pszValue points to.
+ * @param   pfType              Where to return the attribute type value.
+ */
+RTDECL(int) RTManifestQueryAttr(RTMANIFEST hManifest, const char *pszAttr, uint32_t fType,
+                                char *pszValue, size_t cbValue, uint32_t *pfType);
+
+/**
  * Sets an attribute of a manifest entry.
  *
@@ -192 +219 @@
 
 /**
+ * Query a manifest entry attribute.
+ *
+ * @returns IPRT status code.
+ * @retval  VERR_BUFFER_OVERFLOW if the value buffer is too small. The @a
+ *          pszValue buffer will not be modified.
+ * @retval  VERR_NOT_FOUND if the entry was not found.
+ * @retval  VERR_MANIFEST_ATTR_NOT_FOUND
+ * @retval  VERR_MANIFEST_ATTR_TYPE_NOT_FOUND
+ * @retval  VERR_MANIFEST_ATTR_TYPE_MISMATCH
+ *
+ * @param   hManifest           The manifest handle.
+ * @param   pszEntry            The entry name.
+ * @param   pszAttr             The attribute name.  If NULL, it will be
+ *                              selected by @a fType alone.
+ * @param   fType               The attribute types the entry should match. Pass
+ *                              Pass RTMANIFEST_ATTR_ANY match any.  If more
+ *                              than one is given, the first matching one is
+ *                              returned.
+ * @param   pszValue            Where to return value.
+ * @param   cbValue             The size of the buffer @a pszValue points to.
+ * @param   pfType              Where to return the attribute type value.
+ */
+RTDECL(int) RTManifestEntryQueryAttr(RTMANIFEST hManifest, const char *pszEntry, const char *pszAttr, uint32_t fType,
+                                     char *pszValue, size_t cbValue, uint32_t *pfType);
+
+/**
  * Adds a new entry to a manifest.
  *