Revert of Base: Remove Receive() from ScopedHandle.

base/win/scoped_process_information.h

 // Copyright (c) 2012 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 BASE_WIN_SCOPED_PROCESS_INFORMATION_H_
 #define BASE_WIN_SCOPED_PROCESS_INFORMATION_H_
 
 #include <windows.h>
 
 #include "base/basictypes.h"
 #include "base/base_export.h"
 #include "base/win/scoped_handle.h"
 
 namespace base {
 namespace win {
 
 // Manages the closing of process and thread handles from PROCESS_INFORMATION
 // structures. Allows clients to take ownership of either handle independently.
 class BASE_EXPORT ScopedProcessInformation {
  public:
+  // Helper object to contain the effect of Receive() to the funtion that needs
+  // a pointer.
+  class Receiver {
+   public:
+    explicit Receiver(ScopedProcessInformation* owner)
+        : info_(),
+          owner_(owner) {}
+    ~Receiver() { owner_->Set(info_); }
+
+    operator PROCESS_INFORMATION*() { return &info_; }
+
+   private:
+    PROCESS_INFORMATION info_;
+    ScopedProcessInformation* owner_;
+  };
+
   ScopedProcessInformation();
-  explicit ScopedProcessInformation(const PROCESS_INFORMATION& process_info);
   ~ScopedProcessInformation();
 
+  // Returns an object that may be passed to API calls such as CreateProcess.
+  // DCHECKs that the object is not currently holding any handles.
+  // HANDLEs stored in the returned PROCESS_INFORMATION will be owned by this
+  // instance.
+  // The intended use case is something like this:
+  //   if (::CreateProcess(..., startup_info, scoped_proces_info.Receive()))
+  Receiver Receive();
+
   // Returns true iff this instance is holding a thread and/or process handle.
   bool IsValid() const;
 
   // Closes the held thread and process handles, if any.
   void Close();
 
   // Populates this instance with the provided |process_info|.
   void Set(const PROCESS_INFORMATION& process_info);
 
   // Populates this instance with duplicate handles and the thread/process IDs
@@ skipping 39 matching lines @@
   DWORD process_id_;
   DWORD thread_id_;
 
   DISALLOW_COPY_AND_ASSIGN(ScopedProcessInformation);
 };
 
 }  // namespace win
 }  // namespace base
 
 #endif  // BASE_WIN_SCOPED_PROCESS_INFORMATION_H_