{"id":107285,"date":"2022-10-13T07:00:00","date_gmt":"2022-10-13T14:00:00","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/oldnewthing\/?p=107285"},"modified":"2022-10-13T08:22:46","modified_gmt":"2022-10-13T15:22:46","slug":"20221013-00","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/oldnewthing\/20221013-00\/?p=107285","title":{"rendered":"How can I check whether the user’s network connection is roaming or metered?"},"content":{"rendered":"

There are few ways of doing this.<\/p>\n

The classic Win32 way is to call Get\u00adNetwork\u00adConnectivity\u00adHint<\/code>:<\/p>\n

#include <iphlpapi.h>\r\n\r\nNL_NETWORK_CONNECTIVITY_HINT connectivityHint{};\r\nauto error = GetNetworkConnectivityHint(&connectivityHint);\r\nif (error != NO_ERROR) { \/* handle the error somehow *\/ }\r\n<\/pre>\n
The NL_NETWORK_CONNECTIVITY_HINT<\/code> contains information about the type of network you’re on. We’ll come back to this structure later.<\/p>\n
The Windows Runtime way is a little different.<\/p>\n
#include <winrt\/Windows.Networking.Connectivity.h>\r\n\r\nauto connection = winrt::Windows::Networking::Connectivity::\r\n        NetworkInformation::GetInternetConnectionProfile();\r\nif (!connection) { \/* no internet connectivity *\/ }\r\nauto cost = connection.GetConnectionCost();\r\n<\/pre>\n
The NL_NETWORK_CONNECTIVITY_HINT<\/code> and the Connection\u00adCost<\/code> provide roughly the same information.<\/p>\n\n\n\n\n\n\n\n\n\n
NL_NETWORK_CONNECTIVITY_HINT<\/code><\/th>\nConnection\u00adCost<\/code><\/th>\n<\/tr>\n
Connectivity\u00adLevel<\/code><\/td>\nN\/A<\/td>\n<\/tr>\n
Connectivity\u00adCost<\/code><\/td>\nNetwork\u00adCost\u00adType<\/code><\/td>\n<\/tr>\n
Approaching\u00adData\u00adLimit<\/code><\/td>\nApproaching\u00adData\u00adLimit<\/code><\/td>\n<\/tr>\n
Over\u00adData\u00adLimit<\/code><\/td>\nOver\u00adData\u00adLimit<\/code><\/td>\n<\/tr>\n
Roaming<\/code><\/td>\nRoaming<\/code><\/td>\n<\/tr>\n
N\/A<\/td>\nBackground\u00adData\u00adUsage\u00adRestricted<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
The Connectivity\u00adLevel<\/code> is N\/A for Connection\u00adCost<\/code> because the internet connection profile by definition has internet connectivity, so there’s no need for it to tell you.<\/p>\n
The NL_NETWORK_CONNECTIVITY_HINT<\/code> does not tell you whether background data usage is restricted.<\/p>\n
The Connectivity\u00adCost<\/code> \/ Network\u00adCost\u00adType<\/code> tells you how much the network costs.<\/p>\n
    \n
  • Unknown: No information available<\/li>\n
  • Unrestricted: Unlimited<\/li>\n
  • Fixed: Can use up to a fixed limit<\/li>\n
  • Variable: Pay by usage<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
    The classic way and the Windows Runtime way.<\/p>\n","protected":false},"author":1069,"featured_media":111744,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[25],"class_list":["post-107285","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-oldnewthing","tag-code"],"acf":[],"blog_post_summary":"
    The classic way and the Windows Runtime way.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/107285","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/users\/1069"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/comments?post=107285"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/107285\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/media\/111744"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/media?parent=107285"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/categories?post=107285"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/tags?post=107285"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}