Changeset 35188 in vbox for trunk/include/VBox

Timestamp:

Dec 16, 2010 3:13:07 PM (14 years ago)

Author:

vboxsync

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

69027

Message:

Use RTERRINFO in SUPLib for hardening APIs and such.

File:

• trunk/include/VBox/sup.h (modified) (7 diffs)

trunk/include/VBox/sup.h

@@ -894 +894 @@
  * @param   pszModule       The module name. Max 32 bytes.
  * @param   ppvImageBase    Where to store the image address.
- * @param   pszErr          Where to return error message on failure.
- * @param   cbErr           The size of the error buffer.
- */
-SUPR3DECL(int) SUPR3LoadModule(const char *pszFilename, const char *pszModule,
-                               void **ppvImageBase, char *pszErr, size_t cbErr);
+ * @param   pErrInfo        Where to return extended error information.
+ *                          Optional.
+ */
+SUPR3DECL(int) SUPR3LoadModule(const char *pszFilename, const char *pszModule, void **ppvImageBase, PRTERRINFO pErrInfo);
 
 /**
@@ -990 +989 @@
  * @param   fInternal       Set this to @c true if this is an internal
  *                          VirtualBox application.  Otherwise pass @c false.
- * @param   pszErr          Where to return error message on failure.
- * @param   cbErr           The size of the error buffer.
- */
-SUPR3DECL(int) SUPR3HardenedVerifySelf(const char *pszArgv0, bool fInternal, char *pszErr, size_t cbErr);
+ * @param   pErrInfo        Where to return extended error information.
+ */
+SUPR3DECL(int) SUPR3HardenedVerifySelf(const char *pszArgv0, bool fInternal, PRTERRINFO pErrInfo);
 
 /**
@@ -1010 +1008 @@
  * @param   fCheckFiles     Whether to apply the same basic integrity check to
  *                          the files in the directory as the directory itself.
- * @param   pszErr          Where to return error message on failure.
- * @param   cbErr           The size of the error buffer.
- */
-SUPR3DECL(int) SUPR3HardenedVerifyDir(const char *pszDirPath, bool fRecursive, bool fCheckFiles, char *pszErr, size_t cbErr);
+ * @param   pErrInfo        Where to return extended error information.
+ *                          Optional.
+ */
+SUPR3DECL(int) SUPR3HardenedVerifyDir(const char *pszDirPath, bool fRecursive, bool fCheckFiles, PRTERRINFO pErrInfo);
 
 /**
@@ -1025 +1023 @@
  * @param   pszFilename     The filename of the plug-in module (nothing can be
  *                          omitted here).
- * @param   pszErr          Where to return error message on failure.
- * @param   cbErr           The size of the error buffer.
- */
-SUPR3DECL(int) SUPR3HardenedVerifyPlugIn(const char *pszFilename, char *pszErr, size_t cbErr);
+ * @param   pErrInfo        Where to return extended error information.
+ *                          Optional.
+ */
+SUPR3DECL(int) SUPR3HardenedVerifyPlugIn(const char *pszFilename, PRTERRINFO pErrInfo);
 
 /**
@@ -1039 +1037 @@
  * @param   phLdrMod        Where to store the handle to the loaded module.
  * @param   fFlags          See RTLDRFLAGS_.
- * @param   pszError        Where to return error message on failure.
- * @param   cbError         The size of the error buffer.
- */
-SUPR3DECL(int) SUPR3HardenedLdrLoad(const char *pszFilename, PRTLDRMOD phLdrMod, uint32_t fFlags, char *pszError, size_t cbError);
+ * @param   pErrInfo        Where to return extended error information.
+ *                          Optional.
+ */
+SUPR3DECL(int) SUPR3HardenedLdrLoad(const char *pszFilename, PRTLDRMOD phLdrMod, uint32_t fFlags, PRTERRINFO pErrInfo);
 
 /**
@@ -1055 +1053 @@
  * @param   phLdrMod        Where to store the handle to the loaded module.
  * @param   fFlags          See RTLDRFLAGS_*.
- * @param   pszError        Where to return error message on failure.
- * @param   cbError         The size of the error buffer.
- */
-SUPR3DECL(int) SUPR3HardenedLdrLoadAppPriv(const char *pszFilename, PRTLDRMOD phLdrMod, uint32_t fFlags, char *pszError, size_t cbError);
+ * @param   pErrInfo        Where to return extended error information.
+ *                          Optional.
+ */
+SUPR3DECL(int) SUPR3HardenedLdrLoadAppPriv(const char *pszFilename, PRTLDRMOD phLdrMod, uint32_t fFlags, PRTERRINFO pErrInfo);
 
 /**
@@ -1070 +1068 @@
  * @param   pszFilename     The full path to the module, with extension.
  * @param   phLdrMod        Where to store the handle to the loaded module.
- * @param   pszErr          Where to return error message on failure.
- * @param   cbErr           The size of the error buffer.
- */
-SUPR3DECL(int) SUPR3HardenedLdrLoadPlugIn(const char *pszFilename, PRTLDRMOD phLdrMod, char *pszErr, size_t cbErr);
+ * @param   pErrInfo        Where to return extended error information.
+ *                          Optional.
+ */
+SUPR3DECL(int) SUPR3HardenedLdrLoadPlugIn(const char *pszFilename, PRTLDRMOD phLdrMod, PRTERRINFO pErrInfo);
 
 /**