win: Implement exception snapshot

snapshot/win/process_snapshot_win.h

 // Copyright 2015 The Crashpad Authors. All rights reserved.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
 // You may obtain a copy of the License at
 //
 //     http://www.apache.org/licenses/LICENSE-2.0
 //
 // Unless required by applicable law or agreed to in writing, software
 // distributed under the License is distributed on an "AS IS" BASIS,
@@ skipping 13 matching lines @@
 
 #include "base/basictypes.h"
 #include "base/memory/scoped_ptr.h"
 #include "client/crashpad_info.h"
 #include "snapshot/crashpad_info_client_options.h"
 #include "snapshot/exception_snapshot.h"
 #include "snapshot/module_snapshot.h"
 #include "snapshot/process_snapshot.h"
 #include "snapshot/system_snapshot.h"
 #include "snapshot/thread_snapshot.h"
+#include "snapshot/win/exception_snapshot_win.h"
 #include "snapshot/win/module_snapshot_win.h"
 #include "snapshot/win/system_snapshot_win.h"
 #include "snapshot/win/thread_snapshot_win.h"
 #include "util/misc/initialization_state_dcheck.h"
 #include "util/misc/uuid.h"
 #include "util/stdlib/pointer_container.h"
 
 namespace crashpad {
 
 //! \brief A ProcessSnapshot of a running (or crashed) process running on a
 //!     Windows system.
 class ProcessSnapshotWin final : public ProcessSnapshot {
  public:
   ProcessSnapshotWin();
   ~ProcessSnapshotWin() override;
 
   //! \brief Initializes the object.
   //!
   //! \param[in] process The handle to create a snapshot from.
   //!
   //! \return `true` if the snapshot could be created, `false` otherwise with
   //!     an appropriate message logged.
   bool Initialize(HANDLE process);
 
+  //! \brief Initializes the object's exception.
+  //!
+  //! This populates the data to be returned by Exception(). The parameters may
+  //! be passed directly through from a Windows exception handler.
+  //!
+  //! This method must not be called until after a successful call to
+  //! Initialize().
+  //!
+  //! \return `true` if the exception information could be initialized, `false`
+  //!     otherwise with an appropriate message logged. When this method returns
+  //!     `false`, the ProcessSnapshotWin object's validity remains unchanged.
+  bool InitializeException(HANDLE thread,
+                           EXCEPTION_POINTERS* exception_pointers);
+
   //! \brief Sets the value to be returned by ReportID().
   //!
   //! The crash report ID is under the control of the snapshot producer, which
   //! may call this method to set the report ID. If this is not done, ReportID()
   //! will return an identifier consisting entirely of zeroes.
   void SetReportID(const UUID& report_id) { report_id_ = report_id; }
 
   //! \brief Sets the value to be returned by ClientID().
   //!
   //! The client ID is under the control of the snapshot producer, which may
@@ skipping 38 matching lines @@
  private:
   // Initializes threads_ on behalf of Initialize().
   void InitializeThreads();
 
   // Initializes modules_ on behalf of Initialize().
   void InitializeModules();
 
   internal::SystemSnapshotWin system_;
   PointerVector<internal::ThreadSnapshotWin> threads_;
   PointerVector<internal::ModuleSnapshotWin> modules_;
-  // TODO(scottmg): scoped_ptr<internal::ExceptionSnapshotWin> exception_;
+  scoped_ptr<internal::ExceptionSnapshotWin> exception_;
   ProcessReaderWin process_reader_;
   UUID report_id_;
   UUID client_id_;
   std::map<std::string, std::string> annotations_simple_map_;
   timeval snapshot_time_;
   InitializationStateDcheck initialized_;
 
   DISALLOW_COPY_AND_ASSIGN(ProcessSnapshotWin);
 };
 
 }  // namespace crashpad
 
 #endif  // CRASHPAD_SNAPSHOT_WIN_PROCESS_SNAPSHOT_WIN_H_