Changeset 1472 in vbox for trunk/include/VBox/com

Timestamp:

Mar 14, 2007 2:59:26 PM (18 years ago)

Author:

vboxsync

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

19532

Message:

Main: XPCOM: Initial implementation of auto-startable "out-of-proc" VirtualBox component (VBoxSVC).

File:

• trunk/include/VBox/com/ptr.h (modified) (4 diffs)

trunk/include/VBox/com/ptr.h

@@ -251 +251 @@
      *  manage a reference to the created object in case of success.
      */
-    HRESULT createInprocObject (const CLSID &clsid) {
+    HRESULT createInprocObject (const CLSID &clsid)
+    {
         HRESULT rc;
         I *obj = NULL;
@@ -274 +275 @@
      *  to manage a reference to the created object in case of success.
      *
-     *  @param serverName
-     *      name of the server to create the object within (Linux only)
+     *  Note: In XPCOM, the out-of-process functionality is currently emulated
+     *  through in-process wrapper objects (that start a dedicated process and
+     *  redirect all object requests to that process). For this reason, this
+     *  method is fully equivalent to #createInprocObject() for now.
      */
-    HRESULT createLocalObject (const CLSID &clsid, const char *serverName) {
+    HRESULT createLocalObject (const CLSID &clsid)
+    {
+#if defined (__WIN__)
         HRESULT rc;
         I *obj = NULL;
-#if defined (__WIN__)
         rc = CoCreateInstance (clsid, NULL, CLSCTX_LOCAL_SERVER, _ATL_IIDOF (I),
                                (void **) &obj);
+        *this = obj;
+        if (SUCCEEDED (rc))
+            obj->Release();
+        return rc;
 #else
+        return createInprocObject (clsid);
+#endif
+    }
+
+#ifdef VBOX_WITH_XPCOM
+    /**
+     *  Createas an object of the given class ID on the specified server and
+     *  starts to manage a reference to the created object in case of success.
+     *
+     *  @param serverName   Name of the server to create an object within.
+     */
+    HRESULT createObjectOnServer (const CLSID &clsid, const char *serverName)
+    {
+        HRESULT rc;
+        I *obj = NULL;
         nsCOMPtr <ipcIService> ipcServ = do_GetService (IPC_SERVICE_CONTRACTID, &rc);
-        if (SUCCEEDED (rc)) {
+        if (SUCCEEDED (rc))
+        {
             PRUint32 serverID = 0;
             rc = ipcServ->ResolveClientName (serverName, &serverID);
@@ -296 +320 @@
             }
         }
-#endif
         *this = obj;
         if (SUCCEEDED (rc))
@@ -302 +325 @@
         return rc;
     }
+#endif
 };