структура FIXED_INFO_W2KSP1 (iptypes.h)
Структура FIXED_INFO содержит одинаковую информацию во всех интерфейсах компьютера.
Синтаксис
typedef struct {
char HostName[MAX_HOSTNAME_LEN + 4];
char DomainName[MAX_DOMAIN_NAME_LEN + 4];
PIP_ADDR_STRING CurrentDnsServer;
IP_ADDR_STRING DnsServerList;
UINT NodeType;
char ScopeId[MAX_SCOPE_ID_LEN + 4];
UINT EnableRouting;
UINT EnableProxy;
UINT EnableDns;
} FIXED_INFO_W2KSP1, *PFIXED_INFO_W2KSP1;
Члены
HostName[MAX_HOSTNAME_LEN + 4]
Тип: char[MAX_HOSTNAME_LEN + 4]
Имя узла для локального компьютера. Это может быть полное имя узла (включая домен) для компьютера, присоединенного к домену.
DomainName[MAX_DOMAIN_NAME_LEN + 4]
Тип: char[MAX_DOMAIN_NAME_LEN + 4]
Домен, в котором зарегистрирован локальный компьютер.
CurrentDnsServer
Тип: PIP_ADDR_STRING
Зарезервировано. Используйте элемент DnsServerList , чтобы получить DNS-серверы для локального компьютера.
DnsServerList
Тип: IP_ADDR_STRING
Связанный список IP_ADDR_STRING структур, определяющих набор DNS-серверов, используемых локальным компьютером.
NodeType
Тип: UINT
Тип узла локального компьютера. Эти значения определяются в файле заголовка Iptypes.h .
ScopeId[MAX_SCOPE_ID_LEN + 4]
Тип: char[MAX_SCOPE_ID_LEN + 4]
Имя область DHCP.
EnableRouting
Тип: UINT
Логическое значение, указывающее, включена ли маршрутизация на локальном компьютере.
EnableProxy
Тип: UINT
Логическое значение, указывающее, действует ли локальный компьютер в качестве прокси-сервера ARP.
EnableDns
Тип: UINT
Логическое значение, указывающее, включена ли служба DNS на локальном компьютере.
Комментарии
Структура FIXED_INFO извлекается функцией GetNetworkParams .
В пакете sdk для Microsoft Windows определяется структура FIXED_INFO_WIN2KSP1 . При компиляции приложения, если целевой платформой является Windows 2000 с пакетом обновления 1 (SP1) и более поздних версий (NTDDI_VERSION >= NTDDI_WIN2KSP1, _WIN32_WINNT >= 0x0501или WINVER >= 0x0501), структура FIXED_INFO_WIN2KSP1 определяется в FIXED_INFO структуре. При компиляции приложения, если целевой платформой не является Windows 2000 с пакетом обновления 1 (SP1) и более поздних версий, структура FIXED_INFO не определена.
Функция GetNetworkParams и структура FIXED_INFO поддерживаются в Windows 98 и более поздних версий. Но для создания приложения для целевой платформы, более ранней, чем Windows 2000 с пакетом обновления 1 (SP1), необходимо использовать более раннюю версию пакета средств разработки программного обеспечения платформы (SDK).
Примеры
Следующий код извлекает структуру FIXED_INFO , содержащую сведения о конфигурации сети для локального компьютера. Код выводит выбранные элементы из структуры.
//
// Link with IPHlpAPI.lib
//
#include <winsock2.h>
#include <iphlpapi.h>
#include <stdio.h>
#include <windows.h>
#pragma comment(lib, "IPHLPAPI.lib")
#define MALLOC(x) HeapAlloc(GetProcessHeap(), 0, (x))
#define FREE(x) HeapFree(GetProcessHeap(), 0, (x))
/* Note: could also use malloc() and free() */
int __cdecl main()
{
FIXED_INFO *pFixedInfo;
ULONG ulOutBufLen;
DWORD dwRetVal;
IP_ADDR_STRING *pIPAddr;
pFixedInfo = (FIXED_INFO *) MALLOC(sizeof (FIXED_INFO));
if (pFixedInfo == NULL) {
printf("Error allocating memory needed to call GetNetworkParams\n");
return 1;
}
ulOutBufLen = sizeof (FIXED_INFO);
// Make an initial call to GetAdaptersInfo to get
// the necessary size into the ulOutBufLen variable
if (GetNetworkParams(pFixedInfo, &ulOutBufLen) == ERROR_BUFFER_OVERFLOW) {
FREE(pFixedInfo);
pFixedInfo = (FIXED_INFO *) MALLOC(ulOutBufLen);
if (pFixedInfo == NULL) {
printf("Error allocating memory needed to call GetNetworkParams\n");
return 1;
}
}
if (dwRetVal = GetNetworkParams(pFixedInfo, &ulOutBufLen) == NO_ERROR) {
printf("Host Name: %s\n", pFixedInfo->HostName);
printf("Domain Name: %s\n", pFixedInfo->DomainName);
printf("DNS Servers:\n");
printf("\t%s\n", pFixedInfo->DnsServerList.IpAddress.String);
pIPAddr = pFixedInfo->DnsServerList.Next;
while (pIPAddr) {
printf("\t%s\n", pIPAddr->IpAddress.String);
pIPAddr = pIPAddr->Next;
}
printf("Node Type: ");
switch (pFixedInfo->NodeType) {
case BROADCAST_NODETYPE:
printf("Broadcast node\n");
break;
case PEER_TO_PEER_NODETYPE:
printf("Peer to Peer node\n");
break;
case MIXED_NODETYPE:
printf("Mixed node\n");
break;
case HYBRID_NODETYPE:
printf("Hybrid node\n");
break;
default:
printf("Unknown node type %0lx\n", pFixedInfo->NodeType);
break;
}
printf("DHCP scope name: %s\n", pFixedInfo->ScopeId);
if (pFixedInfo->EnableRouting)
printf("Routing: enabled\n");
else
printf("Routing: disabled\n");
if (pFixedInfo->EnableProxy)
printf("ARP proxy: enabled\n");
else
printf("ARP Proxy: disabled\n");
if (pFixedInfo->EnableDns)
printf("DNS: enabled\n");
else
printf("DNS: disabled\n");
} else {
printf("GetNetworkParams failed with error: %d\n", dwRetVal);
return 1;
}
if (pFixedInfo)
FREE(pFixedInfo);
return 0;
}
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхняя часть | iptypes.h (включая Iphlpapi.h) |
См. также раздел
Начальная страница вспомогательного ip-адреса