win_http_transport.hpp

Go to the documentation of this file.

// Copyright (c) Microsoft Corporation.
// Licensed under the MIT License.
 
// cspell: words PCCERT
 
#pragma once
 
#include "azure/core/context.hpp"
#include "azure/core/http/http.hpp"
#include "azure/core/http/policies/policy.hpp"
#include "azure/core/http/transport.hpp"
#include "azure/core/internal/unique_handle.hpp"
#include "azure/core/nullable.hpp"
#include "azure/core/url.hpp"
 
#include <memory>
#include <string>
#include <vector>
 
using PCCERT_CONTEXT = const struct _CERT_CONTEXT*;
 
namespace Azure { namespace Core { namespace Http {
  namespace _detail {
    class WinHttpTransportImpl;
    class WinHttpRequest;
  } // namespace _detail
 
  struct WinHttpTransportOptions final
  {
    bool IgnoreUnknownCertificateAuthority{false};
 
    bool IgnoreInvalidCertificateCommonName{false};
 
    bool EnableSystemDefaultProxy{false};
 
    bool EnableCertificateRevocationListCheck{false};
 
    std::string ProxyInformation;
 
    Azure::Nullable<std::string> ProxyUserName;
 
    Azure::Nullable<std::string> ProxyPassword;
 
    std::vector<std::string> ExpectedTlsRootCertificates;
 
    PCCERT_CONTEXT TlsClientCertificate{nullptr};
  };
 
  class WinHttpTransport : public HttpTransport {
  private:
    std::unique_ptr<_detail::WinHttpTransportImpl> m_impl;
 
  protected:
    virtual void OnUpgradedConnection(
        std::unique_ptr<_detail::WinHttpRequest> const& request) const;
 
  public:
    WinHttpTransport(WinHttpTransportOptions const& options = WinHttpTransportOptions());
 
    WinHttpTransport(Azure::Core::Http::Policies::TransportOptions const& options);
 
    virtual std::unique_ptr<RawResponse> Send(Request& request, Context const& context) override;
 
    // See also:
    // [Core Guidelines C.35: "A base class destructor should be either public
    // and virtual or protected and
    // non-virtual"](http://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c35-a-base-class-destructor-should-be-either-public-and-virtual-or-protected-and-non-virtual)
    virtual ~WinHttpTransport();
 
    // @cond
    friend _detail::WinHttpTransportImpl;
    // @endcond
  };
 
}}} // namespace Azure::Core::Http