win: Implement CRASHPAD_SIMULATE_CRASH()

client/crashpad_client.h

 // Copyright 2014 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,
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
 
 #ifndef CRASHPAD_CLIENT_CRASHPAD_CLIENT_H_
 #define CRASHPAD_CLIENT_CRASHPAD_CLIENT_H_
 
 #include <map>
 #include <string>
 #include <vector>
 
 #include "base/basictypes.h"
 #include "base/files/file_path.h"
 #include "build/build_config.h"
 
 #if defined(OS_MACOSX)
 #include "base/mac/scoped_mach_port.h"
+#elif defined(OS_WIN)
+#include <windows.h>
 #endif
 
 namespace crashpad {
 
 //! \brief The primary interface for an application to have Crashpad monitor
 //!     it for crashes.
 class CrashpadClient {
  public:
   CrashpadClient();
   ~CrashpadClient();
@@ skipping 42 matching lines @@
   //!     until UseHandler() is called.
   //!
   //! The IPC port name (somehow) encodes enough information so that
   //! registration is done with a crash handler using the appropriate database
   //! and upload server.
   //!
   //! \param[in] ipc_port The full name of the crash handler IPC port.
   //!
   //! \return `true` on success and `false` on failure.
   bool SetHandler(const std::string& ipc_port);
+
+  //! \brief Requests that the handler capture a dump even though there hasn't
+  //!     been a crash.
+  //!
+  //! \param[in] context A CONTEXT, generally captured by `RtlCaptureContext()`
+  //!     or similar.
+  //!
+  //! \return `true` on success, `false` on failure with a message logged.

[Mark Mentovai, 2015/09/24 20:37:29]

Nobody checks the return value, so you can just make it return void. But leave
the log message on failure, that’s useful.

[scottmg, 2015/09/24 21:16:59]

Done.

+  static bool DumpWithoutCrash(const CONTEXT& context);
 #endif
 
   //! \brief Configures the process to direct its crashes to a Crashpad handler.
   //!
   //! The Crashpad handler must previously have been started by StartHandler()
   //! or configured by SetHandler().
   //!
   //! On Mac OS X, this method sets the task’s exception port for `EXC_CRASH`,
   //! `EXC_RESOURCE`, and `EXC_GUARD` exceptions to the Mach send right obtained
   //! by StartHandler(). The handler will be installed with behavior
@@ skipping 17 matching lines @@
 #if defined(OS_MACOSX)
   base::mac::ScopedMachSendRight exception_port_;
 #endif
 
   DISALLOW_COPY_AND_ASSIGN(CrashpadClient);
 };
 
 }  // namespace crashpad
 
 #endif  // CRASHPAD_CLIENT_CRASHPAD_CLIENT_H_