Changeset 80778 in vbox

Timestamp:

Sep 13, 2019 1:18:21 PM (6 years ago)

Author:

vboxsync

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

133343

Message:

VBox/com/array.h: Adding ComSafeArrayNullInParam. bugref:9341

File:

• trunk/include/VBox/com/array.h (modified) (3 diffs)

trunk/include/VBox/com/array.h

@@ -188 +188 @@
 #include "iprt/cpp/list.h"
 
-#ifdef VBOX_WITH_XPCOM
-
-/**
+/** @def ComSafeArrayAsInParam
  * Wraps the given com::SafeArray instance to generate an expression that is
  * suitable for passing it to functions that take input safearray parameters
@@ -197 +195 @@
  * @param aArray    com::SafeArray instance to pass as an input parameter.
  */
-#define ComSafeArrayAsInParam(aArray)   \
-    (PRUint32)(aArray).size(), (aArray).__asInParam_Arr((aArray).raw())
-
-/**
+
+/** @def ComSafeArrayAsOutParam
  * Wraps the given com::SafeArray instance to generate an expression that is
  * suitable for passing it to functions that take output safearray parameters
@@ -207 +203 @@
  * @param aArray    com::SafeArray instance to pass as an output parameter.
  */
-#define ComSafeArrayAsOutParam(aArray)  \
+
+/** @def ComSafeArrayNullInParam
+ * Helper for passing a NULL array parameter to a COM / XPCOM method.
+ */
+
+#ifdef VBOX_WITH_XPCOM
+
+# define ComSafeArrayAsInParam(aArray) \
+    (PRUint32)(aArray).size(), (aArray).__asInParam_Arr((aArray).raw())
+
+# define ComSafeArrayAsOutParam(aArray) \
     (aArray).__asOutParam_Size(), (aArray).__asOutParam_Arr()
 
+# define ComSafeArrayNullInParam()      0, NULL
+
 #else /* !VBOX_WITH_XPCOM */
 
-#define ComSafeArrayAsInParam(aArray)   (aArray).__asInParam()
-
-#define ComSafeArrayAsOutParam(aArray)  (aArray).__asOutParam()
+# define ComSafeArrayAsInParam(aArray)  (aArray).__asInParam()
+
+# define ComSafeArrayAsOutParam(aArray) (aArray).__asOutParam()
+
+# define ComSafeArrayNullInParam()      (NULL)
 
 #endif /* !VBOX_WITH_XPCOM */