OLD | NEW |
| (Empty) |
1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. | |
2 // Use of this source code is governed by a BSD-style license that can be | |
3 // found in the LICENSE file. | |
4 | |
5 #ifndef CHROME_COMMON_WIN_SAFE_UTIL_H_ | |
6 #define CHROME_COMMON_WIN_SAFE_UTIL_H_ | |
7 #pragma once | |
8 | |
9 #include <string> | |
10 #include <windows.h> | |
11 | |
12 class FilePath; | |
13 | |
14 namespace win_util { | |
15 | |
16 // Open or run a downloaded file via the Windows shell, possibly showing first | |
17 // a consent dialog if the the file is deemed dangerous. This function is an | |
18 // enhancement over the OpenItemViaShell() function of win_util.h. | |
19 // | |
20 // The user consent dialog will be shown or not according to the windows | |
21 // execution policy defined in the registry which can be overridden per user. | |
22 // The mechanics of the policy are explained in the Microsoft Knowledge base | |
23 // number 883260: http://support.microsoft.com/kb/883260 | |
24 // | |
25 // The 'hwnd' is the handle to the parent window. In case a dialog is displayed | |
26 // the parent window will be disabled since the dialog is meant to be modal. | |
27 // The 'window_title' is the text displayed on the title bar of the dialog. If | |
28 // you pass an empty string the dialog will have a generic 'windows security' | |
29 // name on the title bar. | |
30 // | |
31 // You must provide a valid 'full_path' to the file to be opened and a well | |
32 // formed url in 'source_url'. The url should identify the source of the file | |
33 // but does not have to be network-reachable. If the url is malformed a | |
34 // dialog will be shown telling the user that the file will be blocked. | |
35 // | |
36 // In the event that there is no default application registered for the file | |
37 // specified by 'full_path' it ask the user, via the Windows "Open With" | |
38 // dialog. | |
39 // Returns 'true' on successful open, 'false' otherwise. | |
40 bool SaferOpenItemViaShell(HWND hwnd, const std::wstring& window_title, | |
41 const FilePath& full_path, | |
42 const std::wstring& source_url); | |
43 | |
44 // Sets the Zone Identifier on the file to "Internet" (3). Returns true if the | |
45 // function succeeds, false otherwise. A failure is expected on system where | |
46 // the Zone Identifier is not supported, like a machine with a FAT32 filesystem. | |
47 // It should not be considered fatal. | |
48 // | |
49 // |full_path| is the path to save the file to, and | |
50 // |source_url| is the URL where the file was downloaded from. | |
51 bool SetInternetZoneIdentifier(const FilePath& full_path, | |
52 const std::wstring& source_url); | |
53 | |
54 } // namespace win_util | |
55 | |
56 #endif // CHROME_COMMON_WIN_SAFE_UTIL_H_ | |
OLD | NEW |