1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
|
// Copyright 2019 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef COMPONENTS_WINHTTP_SCOPED_HINTERNET_H_
#define COMPONENTS_WINHTTP_SCOPED_HINTERNET_H_
#include <windows.h>
#include <winhttp.h>
#include <string_view>
#include "base/memory/ref_counted.h"
#include "base/scoped_generic.h"
namespace winhttp {
namespace internal {
struct ScopedHInternetTraits {
static HINTERNET InvalidValue() { return nullptr; }
static void Free(HINTERNET handle) {
if (handle != InvalidValue()) {
WinHttpCloseHandle(handle);
}
}
};
} // namespace internal
// Manages the lifetime of HINTERNET handles allocated by WinHTTP.
using ScopedHInternet =
base::ScopedGeneric<HINTERNET, internal::ScopedHInternetTraits>;
// Creates a new WinHTTP session using the given user agent and properly
// configured for the Windows OS version.
ScopedHInternet CreateSessionHandle(std::wstring_view user_agent,
int proxy_access_type,
std::wstring_view proxy = {},
std::wstring_view proxy_bypass = {});
// A WinHTTP handle which can be shared. A session handle is typically shared
// by network fetchers since the session maintains the authentication state
// and user-specific cookies.
class SharedHInternet : public base::RefCountedThreadSafe<SharedHInternet> {
public:
explicit SharedHInternet(ScopedHInternet handle);
[[nodiscard]] HINTERNET handle() const { return handle_.get(); }
private:
friend class base::RefCountedThreadSafe<SharedHInternet>;
~SharedHInternet();
const ScopedHInternet handle_;
};
} // namespace winhttp
#endif // COMPONENTS_WINHTTP_SCOPED_HINTERNET_H_
|
