15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2012 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef BASE_WIN_SCOPED_PROCESS_INFORMATION_H_ 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define BASE_WIN_SCOPED_PROCESS_INFORMATION_H_ 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <windows.h> 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/basictypes.h" 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/base_export.h" 122a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#include "base/win/scoped_handle.h" 135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace base { 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace win { 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Manages the closing of process and thread handles from PROCESS_INFORMATION 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// structures. Allows clients to take ownership of either handle independently. 195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class BASE_EXPORT ScopedProcessInformation { 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 212a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Helper object to contain the effect of Receive() to the funtion that needs 222a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // a pointer. 232a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) class Receiver { 242a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) public: 252a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) explicit Receiver(ScopedProcessInformation* owner) 262a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) : info_(), 272a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) owner_(owner) {} 282a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) ~Receiver() { owner_->Set(info_); } 292a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 302a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) operator PROCESS_INFORMATION*() { return &info_; } 312a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 322a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) private: 332a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) PROCESS_INFORMATION info_; 342a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) ScopedProcessInformation* owner_; 352a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) }; 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 372a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) ScopedProcessInformation(); 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ~ScopedProcessInformation(); 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 402a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Returns an object that may be passed to API calls such as CreateProcess. 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // DCHECKs that the object is not currently holding any handles. 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // HANDLEs stored in the returned PROCESS_INFORMATION will be owned by this 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // instance. 442a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // The intended use case is something like this: 452a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // if (::CreateProcess(..., startup_info, scoped_proces_info.Receive())) 462a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) Receiver Receive(); 475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns true iff this instance is holding a thread and/or process handle. 495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool IsValid() const; 505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 512a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Closes the held thread and process handles, if any. 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void Close(); 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 542a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Populates this instance with the provided |process_info|. 552a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) void Set(const PROCESS_INFORMATION& process_info); 565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Populates this instance with duplicate handles and the thread/process IDs 585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // from |other|. Returns false in case of failure, in which case this instance 595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // will be completely unpopulated. 605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool DuplicateFrom(const ScopedProcessInformation& other); 615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Transfers ownership of the held PROCESS_INFORMATION, if any, away from this 632a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // instance. 645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PROCESS_INFORMATION Take(); 655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Transfers ownership of the held process handle, if any, away from this 672a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // instance. Note that the related process_id will also be cleared. 685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) HANDLE TakeProcessHandle(); 695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Transfers ownership of the held thread handle, if any, away from this 712a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // instance. Note that the related thread_id will also be cleared. 725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) HANDLE TakeThreadHandle(); 735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns the held process handle, if any, while retaining ownership. 755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) HANDLE process_handle() const { 762a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) return process_handle_.Get(); 775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns the held thread handle, if any, while retaining ownership. 805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) HANDLE thread_handle() const { 812a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) return thread_handle_.Get(); 825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns the held process id, if any. 855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DWORD process_id() const { 862a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) return process_id_; 875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns the held thread id, if any. 905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DWORD thread_id() const { 912a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) return thread_id_; 925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 952a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) ScopedHandle process_handle_; 962a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) ScopedHandle thread_handle_; 972a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) DWORD process_id_; 982a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) DWORD thread_id_; 995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(ScopedProcessInformation); 1015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 1025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} // namespace win 1045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} // namespace base 1055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif // BASE_WIN_SCOPED_PROCESS_INFORMATION_H_ 107