Adding an API to read module annotations in snapshot.gyp

snapshot/api/module_annotations_win.h

Index: snapshot/api/module_annotations_win.h
diff --git a/snapshot/api/module_annotations_win.h b/snapshot/api/module_annotations_win.h
new file mode 100644
index 0000000000000000000000000000000000000000..47bc865d5d2aae28fa42d0d29e7060573b99ba88
--- /dev/null
+++ b/snapshot/api/module_annotations_win.h
@@ -0,0 +1,42 @@
+// Copyright 2016 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_SNAPSHOT_API_MODULE_ANNOTATIONS_WIN_H_
+#define CRASHPAD_SNAPSHOT_API_MODULE_ANNOTATIONS_WIN_H_
+
+#include <windows.h>
+
+#include <map>
+#include <string>
+
+namespace crashpad {
+
+//! \brief Reads the module annotations from another process.
+//!
+//! \param[in] process The handle to the process that hosts the \a module.
+//!     Requires PROCESS_QUERY_INFORMATION and PROCESS_VM_READ accesses.
+//! \param[in] module The handle to the module from which the \a annotations
+//!     will be read.

[scottmg, 2016/01/18 17:11:59]

The test makes it clear, but note here that `module` should be as loaded in the
target process.

[Patrick Monette, 2016/01/18 19:35:44]

Done.

+//! \param[out] annotations The map that will be filled with the annotations.
+//!     Remains unchanged if the function returns 'false'.
+//!
+//! \return `true` if the annotations could be read succesfully, even if the
+//!     module doesn't contain any annotations.
+bool ReadModuleAnnotations(HANDLE process,
+                           HMODULE module,
+                           std::map<std::string, std::string>* annotations);
+
+}  // namespace crashpad
+
+#endif  // CRASHPAD_SNAPSHOT_API_MODULE_ANNOTATIONS_WIN_H_