OLD | NEW |
1 // Copyright 2015 The Crashpad Authors. All rights reserved. | 1 // Copyright 2015 The Crashpad Authors. All rights reserved. |
2 // | 2 // |
3 // Licensed under the Apache License, Version 2.0 (the "License"); | 3 // Licensed under the Apache License, Version 2.0 (the "License"); |
4 // you may not use this file except in compliance with the License. | 4 // you may not use this file except in compliance with the License. |
5 // You may obtain a copy of the License at | 5 // You may obtain a copy of the License at |
6 // | 6 // |
7 // http://www.apache.org/licenses/LICENSE-2.0 | 7 // http://www.apache.org/licenses/LICENSE-2.0 |
8 // | 8 // |
9 // Unless required by applicable law or agreed to in writing, software | 9 // Unless required by applicable law or agreed to in writing, software |
10 // distributed under the License is distributed on an "AS IS" BASIS, | 10 // distributed under the License is distributed on an "AS IS" BASIS, |
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | 11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
12 // See the License for the specific language governing permissions and | 12 // See the License for the specific language governing permissions and |
13 // limitations under the License. | 13 // limitations under the License. |
14 | 14 |
15 #ifndef CRASHPAD_UTIL_WIN_MODULE_VERSION_H_ | 15 #ifndef CRASHPAD_UTIL_WIN_MODULE_VERSION_H_ |
16 #define CRASHPAD_UTIL_WIN_MODULE_VERSION_H_ | 16 #define CRASHPAD_UTIL_WIN_MODULE_VERSION_H_ |
17 | 17 |
18 #include <windows.h> | 18 #include <windows.h> |
19 | 19 |
20 #include "base/files/file_path.h" | 20 #include "base/files/file_path.h" |
21 | 21 |
22 namespace crashpad { | 22 namespace crashpad { |
23 | 23 |
24 //! \brief Retrieve the type and version information from a given module (exe, | 24 //! \brief Retrieve the type and version information from a given module (exe, |
25 //! dll, etc.) | 25 //! dll, etc.) |
26 //! | 26 //! |
| 27 //! This function calls `GetFileVersionInfo()`, which can implicitly call |
| 28 //! `LoadLibrary()` to load \a path into the calling process. Do not call this |
| 29 //! function on an untrusted module, because there is a risk of executing the |
| 30 //! module’s code. |
| 31 //! |
27 //! \param[in] path The path to the module to be inspected. | 32 //! \param[in] path The path to the module to be inspected. |
28 //! \param[out] vs_fixedfileinfo The `VS_FIXEDFILEINFO` on success. | 33 //! \param[out] vs_fixedfileinfo The VS_FIXEDFILEINFO on success. |
29 //! `dwFileFlags` will have been masked with `dwFileFlagsMask` already. | 34 //! VS_FIXEDFILEINFO::dwFileFlags will have been masked with |
| 35 //! VS_FIXEDFILEINFO::dwFileFlagsMask already. |
30 //! | 36 //! |
31 //! \return `true` on success, or `false` on failure with a message logged. If | 37 //! \return `true` on success, or `false` on failure with a message logged. If |
32 //! the module has no `VERSIONINFO` resource, `false` will be returned | 38 //! the module has no `VERSIONINFO` resource, `false` will be returned |
33 //! without any messages logged. | 39 //! without any messages logged. |
34 bool GetModuleVersionAndType(const base::FilePath& path, | 40 bool GetModuleVersionAndType(const base::FilePath& path, |
35 VS_FIXEDFILEINFO* vs_fixedfileinfo); | 41 VS_FIXEDFILEINFO* vs_fixedfileinfo); |
36 | 42 |
37 } // namespace crashpad | 43 } // namespace crashpad |
38 | 44 |
39 #endif // CRASHPAD_UTIL_WIN_MODULE_VERSION_H_ | 45 #endif // CRASHPAD_UTIL_WIN_MODULE_VERSION_H_ |
OLD | NEW |