Add InspectModule() that returns a populated ModuleInspectionResult struct

chrome/browser/conflicts/module_info_util_win.h

 // Copyright 2017 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 CHROME_BROWSER_CONFLICTS_MODULE_INFO_UTIL_WIN_H_
 #define CHROME_BROWSER_CONFLICTS_MODULE_INFO_UTIL_WIN_H_
 
+#include <utility>
+#include <vector>
+
 #include "base/files/file_path.h"
 #include "base/strings/string16.h"
 
 // The type of certificate found for the module.
 enum class CertificateType {
   // The module is not signed.
   NO_CERTIFICATE,
   // The module is signed and the certificate is in the module.
   CERTIFICATE_IN_FILE,
   // The module is signed and the certificate is in an external catalog.
@@ skipping 15 matching lines @@
   // "Google Inc." or "Microsoft Inc.").
   base::string16 subject;
 };
 
 // Extracts information about the certificate of the given |file|, populating
 // |certificate_info|. It is expected that |certificate_info| be freshly
 // constructed.
 void GetCertificateInfo(const base::FilePath& file,
                         CertificateInfo* certificate_info);
 
+// Returns a mapping of the value of an environment variable to its name.
+//
+// e.g. c:\windows\system32\ -> %systemroot%
+using StringMapping = std::vector<std::pair<base::string16, base::string16>>;
+StringMapping GetEnvironmentVariablesMapping(
+    const std::vector<base::string16>& environment_variables);
+
+// Given a mapping of prefixes to their respective substitution values, searches
+// for a matching prefix in |string| that contains a mapping in |prefix_mapping|
+// and replaces it with its associated value. This function goes over all the
+// values in the mapping to ensure the best fit is chosen.

[chrisha, 2017/02/28 18:51:29]

Not the best wording? Maybe an example as well?

[Patrick Monette, 2017/02/28 23:37:38]

I've reworded this and I think an example is not needed anymore. Let me know if
you disagree.

+void CollapseMatchingPrefixInString(const StringMapping& prefix_mapping,
+                                    base::string16* string);
+
 #endif  // CHROME_BROWSER_CONFLICTS_MODULE_INFO_UTIL_WIN_H_