win: Add CrashpadClient::GetHandlerIPCPipe()

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,
@@ skipping 54 matching lines @@
   //!     specified in this parameter.
   //!
   //! \return `true` on success, `false` on failure with a message logged.
   bool StartHandler(const base::FilePath& handler,
                     const base::FilePath& database,
                     const std::string& url,
                     const std::map<std::string, std::string>& annotations,
                     const std::vector<std::string>& arguments);
 
 #if defined(OS_WIN) || DOXYGEN
-  //! \brief Sets the IPC port of a presumably-running Crashpad handler process
+  //! \brief Sets the IPC pipe of a presumably-running Crashpad handler process
   //!     which was started with StartHandler() or by other compatible means
   //!     and does an IPC message exchange to register this process with the
   //!     handler. However, just like StartHandler(), crashes are not serviced
   //!     until UseHandler() is called.
   //!
-  //! The IPC port name (somehow) encodes enough information so that
+  //! The IPC pipe name (somehow) encodes enough information so that

[scottmg, 2015/11/02 22:15:40]

This paragraph doesn't make sense any longer.

[Mark Mentovai, 2015/11/03 00:08:45]

scottmg wrote:
Removed.

   //! registration is done with a crash handler using the appropriate database
   //! and upload server.
   //!
   //! \param[in] ipc_pipe The full name of the crash handler IPC pipe. This is
   //!     a string of the form `"\\.\pipe\NAME"`.
   //!
   //! \return `true` on success and `false` on failure.
   bool SetHandlerIPCPipe(const std::wstring& ipc_pipe);
 
+  //! \brief Retrieves the IPC pipe name used to register with the Crashpad
+  //!     handler.
+  //!
+  //! This method retrieves the IPC pipe name set by SetHandlerIPCPipe(), or a
+  //! suitable IPC pipe name chosen by StartHandler(). It is intended to be used
+  //! to obtain the IPC pipe name to pass it to other processes, so that they
+  //! may register with an existing Crashpad handler.
+  //!
+  //! This method is only defined on Windows.
+  //!
+  //! \return The full name of the crash handler IPC pipe, a string of the form
+  //!     `"\\.\pipe\NAME"`.
+  std::wstring GetHandlerIPCPipe() const;
+
   //! \brief Requests that the handler capture a dump even though there hasn't
   //!     been a crash.
   //!
   //! \param[in] context A `CONTEXT`, generally captured by CaptureContext() or
   //!     similar.
   static void DumpWithoutCrash(const CONTEXT& context);
 #endif
 
   //! \brief Configures the process to direct its crashes to a Crashpad handler.
   //!
@@ skipping 46 matching lines @@
 #elif defined(OS_WIN)
   std::wstring ipc_pipe_;
 #endif
 
   DISALLOW_COPY_AND_ASSIGN(CrashpadClient);
 };
 
 }  // namespace crashpad
 
 #endif  // CRASHPAD_CLIENT_CRASHPAD_CLIENT_H_