WIP / Do not commit

chrome/browser/platform_util.h

 // Copyright (c) 2011 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROME_BROWSER_PLATFORM_UTIL_H_
 #define CHROME_BROWSER_PLATFORM_UTIL_H_
 #pragma once
 
 #include <string>
 
+#include "base/process.h"
 #include "base/string16.h"
 #include "ui/gfx/native_widget_types.h"
 
 class FilePath;
 class GURL;
 
 namespace platform_util {
 
 // Show the given file in a file manager. If possible, select the file.
 // Must be called from the UI thread.
 void ShowItemInFolder(const FilePath& full_path);
 
 // Open the given file in the desktop's default manner.
 // Must be called from the UI thread.
-void OpenItem(const FilePath& full_path);
+// If |process_handle| is not NULL, it will contain the handle of the newly
+// spawned process that opened the file on Windows and Linux. On Mac or
+// Chrome OS, the process handle will be unchanged.
+// NOTE: In this case, the caller is responsible for closing the handle
+// (on Windows) / ensuring that the process gets reaped (on Linux). Otherwise
+// these things will be done automatically.
+// XXX
+void OpenItem(const FilePath& full_path, base::ProcessHandle* process_handle);
 
 // Open the given external protocol URL in the desktop's default manner.
 // (For example, mailto: URLs in the default mail user agent.)
 void OpenExternal(const GURL& url);
 
 // Get the top level window for the native view. This can return NULL.
 gfx::NativeWindow GetTopLevel(gfx::NativeView view);
 
 // Get the direct parent of |view|, may return NULL.
 gfx::NativeView GetParent(gfx::NativeView view);
 
 // Returns true if |window| is the foreground top level window.
 bool IsWindowActive(gfx::NativeWindow window);
 
 // Activate the window, bringing it to the foreground top level.
 void ActivateWindow(gfx::NativeWindow window);
 
 // Returns true if the view is visible. The exact definition of this is
 // platform-specific, but it is generally not "visible to the user", rather
 // whether the view has the visible attribute set.
 bool IsVisible(gfx::NativeView view);
 
 }  // platform_util
 
 #endif  // CHROME_BROWSER_PLATFORM_UTIL_H_