4 * Copyright (C) 2003 Juan Lang
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
22 * Some observations that an automated test can't produce:
23 * An adapter index is a key for an adapter. That is, if an index is returned
24 * from one API, that same index may be used successfully in another API, as
25 * long as the adapter remains present.
26 * If the adapter is removed and reinserted, however, the index may change (and
27 * indeed it does change on Win2K).
29 * The Name field of the IP_ADAPTER_INDEX_MAP entries returned by
30 * GetInterfaceInfo is declared as a wide string, but the bytes are actually
31 * an ASCII string on some versions of the IP helper API under Win9x. This was
32 * apparently an MS bug, it's corrected in later versions.
34 * The DomainName field of FIXED_INFO isn't NULL-terminated on Win98.
42 #include "wine/test.h"
46 static HMODULE hLibrary = NULL;
48 typedef DWORD (WINAPI *GetNumberOfInterfacesFunc)(PDWORD);
49 typedef DWORD (WINAPI *GetIpAddrTableFunc)(PMIB_IPADDRTABLE,PULONG,BOOL);
50 typedef DWORD (WINAPI *GetIfEntryFunc)(PMIB_IFROW);
51 typedef DWORD (WINAPI *GetFriendlyIfIndexFunc)(DWORD);
52 typedef DWORD (WINAPI *GetIfTableFunc)(PMIB_IFTABLE,PULONG,BOOL);
53 typedef DWORD (WINAPI *GetIpForwardTableFunc)(PMIB_IPFORWARDTABLE,PULONG,BOOL);
54 typedef DWORD (WINAPI *GetIpNetTableFunc)(PMIB_IPNETTABLE,PULONG,BOOL);
55 typedef DWORD (WINAPI *GetInterfaceInfoFunc)(PIP_INTERFACE_INFO,PULONG);
56 typedef DWORD (WINAPI *GetAdaptersInfoFunc)(PIP_ADAPTER_INFO,PULONG);
57 typedef DWORD (WINAPI *GetNetworkParamsFunc)(PFIXED_INFO,PULONG);
58 typedef DWORD (WINAPI *GetIcmpStatisticsFunc)(PMIB_ICMP);
59 typedef DWORD (WINAPI *GetIpStatisticsFunc)(PMIB_IPSTATS);
60 typedef DWORD (WINAPI *GetTcpStatisticsFunc)(PMIB_TCPSTATS);
61 typedef DWORD (WINAPI *GetUdpStatisticsFunc)(PMIB_UDPSTATS);
62 typedef DWORD (WINAPI *GetTcpTableFunc)(PMIB_TCPTABLE,PDWORD,BOOL);
63 typedef DWORD (WINAPI *GetUdpTableFunc)(PMIB_UDPTABLE,PDWORD,BOOL);
64 typedef DWORD (WINAPI *GetPerAdapterInfoFunc)(ULONG,PIP_PER_ADAPTER_INFO,PULONG);
66 static GetNumberOfInterfacesFunc gGetNumberOfInterfaces = NULL;
67 static GetIpAddrTableFunc gGetIpAddrTable = NULL;
68 static GetIfEntryFunc gGetIfEntry = NULL;
69 static GetFriendlyIfIndexFunc gGetFriendlyIfIndex = NULL;
70 static GetIfTableFunc gGetIfTable = NULL;
71 static GetIpForwardTableFunc gGetIpForwardTable = NULL;
72 static GetIpNetTableFunc gGetIpNetTable = NULL;
73 static GetInterfaceInfoFunc gGetInterfaceInfo = NULL;
74 static GetAdaptersInfoFunc gGetAdaptersInfo = NULL;
75 static GetNetworkParamsFunc gGetNetworkParams = NULL;
76 static GetIcmpStatisticsFunc gGetIcmpStatistics = NULL;
77 static GetIpStatisticsFunc gGetIpStatistics = NULL;
78 static GetTcpStatisticsFunc gGetTcpStatistics = NULL;
79 static GetUdpStatisticsFunc gGetUdpStatistics = NULL;
80 static GetTcpTableFunc gGetTcpTable = NULL;
81 static GetUdpTableFunc gGetUdpTable = NULL;
82 static GetPerAdapterInfoFunc gGetPerAdapterInfo = NULL;
84 static void loadIPHlpApi(void)
86 hLibrary = LoadLibraryA("iphlpapi.dll");
88 gGetNumberOfInterfaces = (GetNumberOfInterfacesFunc)GetProcAddress(
89 hLibrary, "GetNumberOfInterfaces");
90 gGetIpAddrTable = (GetIpAddrTableFunc)GetProcAddress(
91 hLibrary, "GetIpAddrTable");
92 gGetIfEntry = (GetIfEntryFunc)GetProcAddress(
93 hLibrary, "GetIfEntry");
94 gGetFriendlyIfIndex = (GetFriendlyIfIndexFunc)GetProcAddress(
95 hLibrary, "GetFriendlyIfIndex");
96 gGetIfTable = (GetIfTableFunc)GetProcAddress(
97 hLibrary, "GetIfTable");
98 gGetIpForwardTable = (GetIpForwardTableFunc)GetProcAddress(
99 hLibrary, "GetIpForwardTable");
100 gGetIpNetTable = (GetIpNetTableFunc)GetProcAddress(
101 hLibrary, "GetIpNetTable");
102 gGetInterfaceInfo = (GetInterfaceInfoFunc)GetProcAddress(
103 hLibrary, "GetInterfaceInfo");
104 gGetAdaptersInfo = (GetAdaptersInfoFunc)GetProcAddress(
105 hLibrary, "GetAdaptersInfo");
106 gGetNetworkParams = (GetNetworkParamsFunc)GetProcAddress(
107 hLibrary, "GetNetworkParams");
108 gGetIcmpStatistics = (GetIcmpStatisticsFunc)GetProcAddress(
109 hLibrary, "GetIcmpStatistics");
110 gGetIpStatistics = (GetIpStatisticsFunc)GetProcAddress(
111 hLibrary, "GetIpStatistics");
112 gGetTcpStatistics = (GetTcpStatisticsFunc)GetProcAddress(
113 hLibrary, "GetTcpStatistics");
114 gGetUdpStatistics = (GetUdpStatisticsFunc)GetProcAddress(
115 hLibrary, "GetUdpStatistics");
116 gGetTcpTable = (GetTcpTableFunc)GetProcAddress(
117 hLibrary, "GetTcpTable");
118 gGetUdpTable = (GetUdpTableFunc)GetProcAddress(
119 hLibrary, "GetUdpTable");
120 gGetPerAdapterInfo = (GetPerAdapterInfoFunc)GetProcAddress(hLibrary, "GetPerAdapterInfo");
124 static void freeIPHlpApi(void)
127 gGetNumberOfInterfaces = NULL;
128 gGetIpAddrTable = NULL;
130 gGetFriendlyIfIndex = NULL;
132 gGetIpForwardTable = NULL;
133 gGetIpNetTable = NULL;
134 gGetInterfaceInfo = NULL;
135 gGetAdaptersInfo = NULL;
136 gGetNetworkParams = NULL;
137 gGetIcmpStatistics = NULL;
138 gGetIpStatistics = NULL;
139 gGetTcpStatistics = NULL;
140 gGetUdpStatistics = NULL;
143 FreeLibrary(hLibrary);
149 still-to-be-tested 98-only functions:
150 GetUniDirectionalAdapterInfo
152 static void testWin98OnlyFunctions(void)
156 static void testGetNumberOfInterfaces(void)
158 if (gGetNumberOfInterfaces) {
159 DWORD apiReturn, numInterfaces;
161 /* Crashes on Vista */
163 apiReturn = gGetNumberOfInterfaces(NULL), numInterfaces;
164 if (apiReturn == ERROR_NOT_SUPPORTED)
166 ok(apiReturn == ERROR_INVALID_PARAMETER,
167 "GetNumberOfInterfaces(NULL) returned %d, expected ERROR_INVALID_PARAMETER\n",
171 apiReturn = gGetNumberOfInterfaces(&numInterfaces);
172 if (apiReturn == ERROR_NOT_SUPPORTED) {
173 skip("GetNumberOfInterfaces is not supported\n");
176 ok(apiReturn == NO_ERROR,
177 "GetNumberOfInterfaces returned %d, expected 0\n", apiReturn);
181 static void testGetIfEntry(DWORD index)
187 memset(&row, 0, sizeof(row));
188 apiReturn = gGetIfEntry(NULL);
189 if (apiReturn == ERROR_NOT_SUPPORTED)
191 ok(apiReturn == ERROR_INVALID_PARAMETER,
192 "GetIfEntry(NULL) returned %d, expected ERROR_INVALID_PARAMETER\n",
194 row.dwIndex = -1; /* hope that's always bogus! */
195 apiReturn = gGetIfEntry(&row);
196 ok(apiReturn == ERROR_INVALID_DATA ||
197 apiReturn == ERROR_FILE_NOT_FOUND /* Vista */,
198 "GetIfEntry(bogus row) returned %d, expected ERROR_INVALID_DATA or ERROR_FILE_NOT_FOUND\n",
201 apiReturn = gGetIfEntry(&row);
202 ok(apiReturn == NO_ERROR,
203 "GetIfEntry returned %d, expected NO_ERROR\n", apiReturn);
207 static void testGetIpAddrTable(void)
209 if (gGetIpAddrTable) {
213 apiReturn = gGetIpAddrTable(NULL, NULL, FALSE);
214 if (apiReturn == ERROR_NOT_SUPPORTED)
216 ok(apiReturn == ERROR_INVALID_PARAMETER,
217 "GetIpAddrTable(NULL, NULL, FALSE) returned %d, expected ERROR_INVALID_PARAMETER\n",
219 apiReturn = gGetIpAddrTable(NULL, &dwSize, FALSE);
220 ok(apiReturn == ERROR_INSUFFICIENT_BUFFER,
221 "GetIpAddrTable(NULL, &dwSize, FALSE) returned %d, expected ERROR_INSUFFICIENT_BUFFER\n",
223 if (apiReturn == ERROR_INSUFFICIENT_BUFFER) {
224 PMIB_IPADDRTABLE buf = (PMIB_IPADDRTABLE)malloc(dwSize);
226 apiReturn = gGetIpAddrTable(buf, &dwSize, FALSE);
227 ok(apiReturn == NO_ERROR,
228 "GetIpAddrTable(buf, &dwSize, FALSE) returned %d, expected NO_ERROR\n",
230 if (apiReturn == NO_ERROR && buf->dwNumEntries)
231 testGetIfEntry(buf->table[0].dwIndex);
237 static void testGetIfTable(void)
243 apiReturn = gGetIfTable(NULL, NULL, FALSE);
244 if (apiReturn == ERROR_NOT_SUPPORTED)
246 ok(apiReturn == ERROR_INVALID_PARAMETER,
247 "GetIfTable(NULL, NULL, FALSE) returned %d, expected ERROR_INVALID_PARAMETER\n",
249 apiReturn = gGetIfTable(NULL, &dwSize, FALSE);
250 ok(apiReturn == ERROR_INSUFFICIENT_BUFFER,
251 "GetIfTable(NULL, &dwSize, FALSE) returned %d, expected ERROR_INSUFFICIENT_BUFFER\n",
253 if (apiReturn == ERROR_INSUFFICIENT_BUFFER) {
254 PMIB_IFTABLE buf = (PMIB_IFTABLE)malloc(dwSize);
256 apiReturn = gGetIfTable(buf, &dwSize, FALSE);
257 ok(apiReturn == NO_ERROR,
258 "GetIfTable(buf, &dwSize, FALSE) returned %d, expected NO_ERROR\n\n",
265 static void testGetIpForwardTable(void)
267 if (gGetIpForwardTable) {
271 apiReturn = gGetIpForwardTable(NULL, NULL, FALSE);
272 if (apiReturn == ERROR_NOT_SUPPORTED)
274 ok(apiReturn == ERROR_INVALID_PARAMETER,
275 "GetIpForwardTable(NULL, NULL, FALSE) returned %d, expected ERROR_INVALID_PARAMETER\n",
277 apiReturn = gGetIpForwardTable(NULL, &dwSize, FALSE);
278 ok(apiReturn == ERROR_INSUFFICIENT_BUFFER,
279 "GetIpForwardTable(NULL, &dwSize, FALSE) returned %d, expected ERROR_INSUFFICIENT_BUFFER\n",
281 if (apiReturn == ERROR_INSUFFICIENT_BUFFER) {
282 PMIB_IPFORWARDTABLE buf = (PMIB_IPFORWARDTABLE)malloc(dwSize);
284 apiReturn = gGetIpForwardTable(buf, &dwSize, FALSE);
285 ok(apiReturn == NO_ERROR,
286 "GetIpForwardTable(buf, &dwSize, FALSE) returned %d, expected NO_ERROR\n",
293 static void testGetIpNetTable(void)
295 if (gGetIpNetTable) {
299 apiReturn = gGetIpNetTable(NULL, NULL, FALSE);
300 if (apiReturn == ERROR_NOT_SUPPORTED)
302 ok(apiReturn == ERROR_INVALID_PARAMETER,
303 "GetIpNetTable(NULL, NULL, FALSE) returned %d, expected ERROR_INVALID_PARAMETER\n",
305 apiReturn = gGetIpNetTable(NULL, &dwSize, FALSE);
306 ok(apiReturn == ERROR_NO_DATA || apiReturn == ERROR_INSUFFICIENT_BUFFER,
307 "GetIpNetTable(NULL, &dwSize, FALSE) returned %d, expected ERROR_NO_DATA or ERROR_INSUFFICIENT_BUFFER\n",
309 if (apiReturn == ERROR_NO_DATA)
310 ; /* empty ARP table's okay */
311 else if (apiReturn == ERROR_INSUFFICIENT_BUFFER) {
312 PMIB_IPNETTABLE buf = (PMIB_IPNETTABLE)malloc(dwSize);
314 apiReturn = gGetIpNetTable(buf, &dwSize, FALSE);
315 ok(apiReturn == NO_ERROR,
316 "GetIpNetTable(buf, &dwSize, FALSE) returned %d, expected NO_ERROR\n",
323 static void testGetIcmpStatistics(void)
325 if (gGetIcmpStatistics) {
329 /* Crashes on Vista */
331 apiReturn = gGetIcmpStatistics(NULL);
332 if (apiReturn == ERROR_NOT_SUPPORTED)
334 ok(apiReturn == ERROR_INVALID_PARAMETER,
335 "GetIcmpStatistics(NULL) returned %d, expected ERROR_INVALID_PARAMETER\n",
339 apiReturn = gGetIcmpStatistics(&stats);
340 if (apiReturn == ERROR_NOT_SUPPORTED)
342 skip("GetIcmpStatistics is not supported\n");
345 ok(apiReturn == NO_ERROR,
346 "GetIcmpStatistics returned %d, expected NO_ERROR\n", apiReturn);
350 static void testGetIpStatistics(void)
352 if (gGetIpStatistics) {
356 apiReturn = gGetIpStatistics(NULL);
357 if (apiReturn == ERROR_NOT_SUPPORTED)
359 ok(apiReturn == ERROR_INVALID_PARAMETER,
360 "GetIpStatistics(NULL) returned %d, expected ERROR_INVALID_PARAMETER\n",
362 apiReturn = gGetIpStatistics(&stats);
363 ok(apiReturn == NO_ERROR,
364 "GetIpStatistics returned %d, expected NO_ERROR\n", apiReturn);
368 static void testGetTcpStatistics(void)
370 if (gGetTcpStatistics) {
374 apiReturn = gGetTcpStatistics(NULL);
375 if (apiReturn == ERROR_NOT_SUPPORTED)
377 ok(apiReturn == ERROR_INVALID_PARAMETER,
378 "GetTcpStatistics(NULL) returned %d, expected ERROR_INVALID_PARAMETER\n",
380 apiReturn = gGetTcpStatistics(&stats);
381 ok(apiReturn == NO_ERROR,
382 "GetTcpStatistics returned %d, expected NO_ERROR\n", apiReturn);
386 static void testGetUdpStatistics(void)
388 if (gGetUdpStatistics) {
392 apiReturn = gGetUdpStatistics(NULL);
393 if (apiReturn == ERROR_NOT_SUPPORTED)
395 ok(apiReturn == ERROR_INVALID_PARAMETER,
396 "GetUdpStatistics(NULL) returned %d, expected ERROR_INVALID_PARAMETER\n",
398 apiReturn = gGetUdpStatistics(&stats);
399 ok(apiReturn == NO_ERROR,
400 "GetUdpStatistics returned %d, expected NO_ERROR\n", apiReturn);
404 static void testGetTcpTable(void)
410 apiReturn = gGetTcpTable(NULL, NULL, FALSE);
411 if (apiReturn == ERROR_NOT_SUPPORTED)
413 ok(apiReturn == ERROR_INVALID_PARAMETER,
414 "GetTcpTable(NULL, NULL, FALSE) returned %d, expected ERROR_INVALID_PARAMETER\n",
416 apiReturn = gGetTcpTable(NULL, &dwSize, FALSE);
417 ok(apiReturn == ERROR_INSUFFICIENT_BUFFER,
418 "GetTcpTable(NULL, &dwSize, FALSE) returned %d, expected ERROR_INSUFFICIENT_BUFFER\n",
420 if (apiReturn == ERROR_INSUFFICIENT_BUFFER) {
421 PMIB_TCPTABLE buf = (PMIB_TCPTABLE)malloc(dwSize);
423 apiReturn = gGetTcpTable(buf, &dwSize, FALSE);
424 ok(apiReturn == NO_ERROR,
425 "GetTcpTable(buf, &dwSize, FALSE) returned %d, expected NO_ERROR\n",
432 static void testGetUdpTable(void)
438 apiReturn = gGetUdpTable(NULL, NULL, FALSE);
439 if (apiReturn == ERROR_NOT_SUPPORTED)
441 ok(apiReturn == ERROR_INVALID_PARAMETER,
442 "GetUdpTable(NULL, NULL, FALSE) returned %d, expected ERROR_INVALID_PARAMETER\n",
444 apiReturn = gGetUdpTable(NULL, &dwSize, FALSE);
445 ok(apiReturn == ERROR_INSUFFICIENT_BUFFER,
446 "GetUdpTable(NULL, &dwSize, FALSE) returned %d, expected ERROR_INSUFFICIENT_BUFFER\n",
448 if (apiReturn != ERROR_INSUFFICIENT_BUFFER) {
449 PMIB_UDPTABLE buf = (PMIB_UDPTABLE)malloc(dwSize);
451 apiReturn = gGetUdpTable(buf, &dwSize, FALSE);
452 ok(apiReturn == NO_ERROR,
453 "GetUdpTable(buf, &dwSize, FALSE) returned %d, expected NO_ERROR\n",
461 still-to-be-tested NT4-onward functions:
475 static void testWinNT4Functions(void)
477 testGetNumberOfInterfaces();
478 testGetIpAddrTable();
480 testGetIpForwardTable();
482 testGetIcmpStatistics();
483 testGetIpStatistics();
484 testGetTcpStatistics();
485 testGetUdpStatistics();
490 static void testGetInterfaceInfo(void)
492 if (gGetInterfaceInfo) {
496 apiReturn = gGetInterfaceInfo(NULL, NULL);
497 if (apiReturn == ERROR_NOT_SUPPORTED)
499 ok(apiReturn == ERROR_INVALID_PARAMETER,
500 "GetInterfaceInfo returned %d, expected ERROR_INVALID_PARAMETER\n",
502 apiReturn = gGetInterfaceInfo(NULL, &len);
503 ok(apiReturn == ERROR_INSUFFICIENT_BUFFER,
504 "GetInterfaceInfo returned %d, expected ERROR_INSUFFICIENT_BUFFER\n",
506 if (apiReturn == ERROR_INSUFFICIENT_BUFFER) {
507 PIP_INTERFACE_INFO buf = (PIP_INTERFACE_INFO)malloc(len);
509 apiReturn = gGetInterfaceInfo(buf, &len);
510 ok(apiReturn == NO_ERROR,
511 "GetInterfaceInfo(buf, &dwSize) returned %d, expected NO_ERROR\n",
518 static void testGetAdaptersInfo(void)
520 if (gGetAdaptersInfo) {
524 apiReturn = gGetAdaptersInfo(NULL, NULL);
525 if (apiReturn == ERROR_NOT_SUPPORTED)
527 ok(apiReturn == ERROR_INVALID_PARAMETER,
528 "GetAdaptersInfo returned %d, expected ERROR_INVALID_PARAMETER\n",
530 apiReturn = gGetAdaptersInfo(NULL, &len);
531 ok(apiReturn == ERROR_NO_DATA || apiReturn == ERROR_BUFFER_OVERFLOW,
532 "GetAdaptersInfo returned %d, expected ERROR_NO_DATA or ERROR_BUFFER_OVERFLOW\n",
534 if (apiReturn == ERROR_NO_DATA)
535 ; /* no adapter's, that's okay */
536 else if (apiReturn == ERROR_BUFFER_OVERFLOW) {
537 PIP_ADAPTER_INFO buf = (PIP_ADAPTER_INFO)malloc(len);
539 apiReturn = gGetAdaptersInfo(buf, &len);
540 ok(apiReturn == NO_ERROR,
541 "GetAdaptersInfo(buf, &dwSize) returned %d, expected NO_ERROR\n",
548 static void testGetNetworkParams(void)
550 if (gGetNetworkParams) {
554 apiReturn = gGetNetworkParams(NULL, NULL);
555 if (apiReturn == ERROR_NOT_SUPPORTED)
557 ok(apiReturn == ERROR_INVALID_PARAMETER,
558 "GetNetworkParams returned %d, expected ERROR_INVALID_PARAMETER\n",
560 apiReturn = gGetNetworkParams(NULL, &len);
561 ok(apiReturn == ERROR_BUFFER_OVERFLOW,
562 "GetNetworkParams returned %d, expected ERROR_BUFFER_OVERFLOW\n",
564 if (apiReturn == ERROR_BUFFER_OVERFLOW) {
565 PFIXED_INFO buf = (PFIXED_INFO)malloc(len);
567 apiReturn = gGetNetworkParams(buf, &len);
568 ok(apiReturn == NO_ERROR,
569 "GetNetworkParams(buf, &dwSize) returned %d, expected NO_ERROR\n",
577 still-to-be-tested 98-onward functions:
583 static void testWin98Functions(void)
585 testGetInterfaceInfo();
586 testGetAdaptersInfo();
587 testGetNetworkParams();
590 static void testGetPerAdapterInfo(void)
595 if (!gGetPerAdapterInfo) return;
596 ret = gGetPerAdapterInfo(1, NULL, NULL);
597 ok( ret == ERROR_INVALID_PARAMETER, "got %u instead of ERROR_INVALID_PARAMETER\n", ret );
599 ret = gGetPerAdapterInfo(1, NULL, &needed);
600 if (ret == ERROR_NO_DATA) return; /* no such adapter */
601 ok( ret == ERROR_BUFFER_OVERFLOW, "got %u instead of ERROR_BUFFER_OVERFLOW\n", ret );
602 ok( needed != 0xdeadbeef, "needed not set\n" );
603 buffer = HeapAlloc( GetProcessHeap(), 0, needed );
604 ret = gGetPerAdapterInfo(1, buffer, &needed);
605 ok( ret == NO_ERROR, "got %u instead of NO_ERROR\n", ret );
606 HeapFree( GetProcessHeap(), 0, buffer );
610 still-to-be-tested 2K-onward functions:
623 static void testWin2KFunctions(void)
625 testGetPerAdapterInfo();
633 testWin98OnlyFunctions();
634 testWinNT4Functions();
635 testWin98Functions();
636 testWin2KFunctions();