Documentation for "Get the current IP configuration" outdated

[druske]

There are elements of this GET request missing from the documentation:

• DDNSEnabled is a boolean that is true when DHCP is used to resolve DNS addresses, or false when static DNS addresses have been specified.
• There is a DNSAddresses array that is populated with a list of the DNS addresses.

There is also an element documented that is no longer part of the response message:

• The WINS is not sent in response to this request. While this is documented as optional, it does not appear that Windows 10 IoT Core supports WINS servers (attempting to set a static WINS server using netsh.exe has no effect, for instance).

Finally, it should perhaps be documented that the DHCP value is omitted in the response when an adapter is configured with a static IP address.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 606c1247-47ba-a3fd-3abc-c072336bf019
• Version Independent ID: 729ff3d9-ebe0-bf23-605c-1ea1b0f2d3bd
• Content: Windows Device Portal core REST API reference - UWP applications
• Content Source: windows-apps-src/debug-test-perf/device-portal-api-core.md
• Product: uwp
• Technology: deployment
• GitHub Login: @Karl-Bridge-Microsoft
• Microsoft Alias: kbridge

[druske]

One additional comment: While the DDNSEnabled boolean is useful --- there are no obvious APIs in Win32, .NET, or WMI for determining whether DNS addresses are set statically or by DHCP --- it is apparently not the same as the DDnsEnabled field in Win32's IP_ADAPTER_ADDRESSES_LH structure. The Win32 field seems to be the same as .NET's IPInterfaceProperties.IsDynamicDnsEnabled field for dynamic DNS, which is something quite different. The choice of the name "DDNSEnabled" for IoT Core's REST API is, unfortunately, a little confusing due to its history in Win32.

[druske]

It's right there in the subject line. "Get the current IP configuration" is a GET method at the request URI "/api/networking/ipconfig". https://docs.microsoft.com/en-us/windows/uwp/debug-test-perf/device-portal-api-core#get-the-current-ip-configuration <https://docs.microsoft.com/en-us/windows/uwp/debug-test-perf/device-portal-api-core#get-the-current-ip-configuration> Dave

…

On Jul 9, 2021, at 1:27 PM, KB ***@***.***> wrote: Hi @druske <https://github.com/druske> - can you clarify which REST API you're referring to in this issue? Thanks! — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#2964 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AJY5HLVHSDOU7YJZRXDTMQDTW45QXANCNFSM4XNPKHIQ>.