Метод SetWINSServer класса Win32_NetworkAdapterConfiguration
Метод класса SetWINSServerWMI задает основной и дополнительный серверы службы именования Windows (WINS) на этом сетевом адаптере, привязанном к TCP/IP. Этот метод применяется независимо от сетевого адаптера.
В этом разделе используется синтаксис MOF. Дополнительные сведения об использовании этого метода см. в разделе Вызов метода .
Синтаксис
uint32 SetWINSServer(
[in] string WINSPrimaryServer,
[in] string WINSSecondaryServer
);
Параметры
-
WINSPrimaryServer [in]
-
IP-адрес основного WINS-сервера.
Примечание
Всегда проверяйте допустимость этого IP-адреса, если он получен из неизвестного источника или источника, которому вы не доверяете.
-
WINSSecondaryServer [in]
-
IP-адрес вторичного WINS-сервера.
Примечание
Всегда проверяйте допустимость этого IP-адреса, если он получен из неизвестного источника или источника, которому вы не доверяете.
Возвращаемое значение
Возвращает целочисленное значение 0 (ноль) при успешном завершении и любое другое число, указывающее на ошибку. Дополнительные сведения о кодах ошибок см. в разделе Константы ошибок WMI или WbemErrorEnum. Общие значения HRESULT см. в разделе Системные коды ошибок.
-
Успешное завершение, перезагрузка не требуется
-
0
Успешное завершение, перезагрузка не требуется.
-
Успешное завершение, требуется перезагрузка
-
1
Успешное завершение, требуется перезагрузка.
-
Метод не поддерживается на этой платформе
-
64
Метод не поддерживается на этой платформе.
-
Неизвестный сбой
-
65
Неизвестный сбой.
-
Недопустимая маска подсети
-
66
Недопустимая маска подсети.
-
Ошибка при обработке возвращенного экземпляра
-
67
Ошибка при обработке возвращенного экземпляра.
-
Недопустимый входной параметр
-
68
Недопустимый входной параметр.
-
Указано более 5 шлюзов
-
69
Указано более пяти шлюзов.
-
Недопустимый IP-адрес
-
70
Недопустимый IP-адрес.
-
Недопустимый IP-адрес шлюза
-
71
Недопустимый IP-адрес шлюза.
-
Произошла ошибка при доступе к реестру для получения запрошенных сведений.
-
72
Произошла ошибка при доступе к реестру для запрашиваемых сведений.
-
Недопустимое доменное имя
-
73
Недопустимое доменное имя.
-
Недопустимое имя узла
-
74
Недопустимое имя узла.
-
Основной или вторичный сервер WINS не определен
-
75
Основной или вторичный сервер WINS не определен.
-
Недопустимый файл
-
76
Недопустимый файл.
-
Недопустимый системный путь
-
77
Недопустимый системный путь.
-
Сбой копирования файла
-
78
Сбой копирования файла.
-
Недопустимый параметр безопасности
-
79
Недопустимый параметр безопасности.
-
Не удалось настроить службу TCP/IP
-
80
Не удалось настроить службу TCP/IP.
-
Не удается настроить службу DHCP
-
81
Не удалось настроить службу DHCP.
-
Не удается продлить аренду DHCP
-
82
Не удается продлить аренду DHCP.
-
Не удалось освободить аренду DHCP
-
83
Не удается освободить аренду DHCP.
-
IP-адрес не включен на адаптере
-
84
IP-адрес не включен на адаптере.
-
IPX не включен на адаптере
-
85
IPX не включен на адаптере.
-
Ошибка границ кадра или сетевого номера
-
86
Ошибка границы кадра или сетевого номера.
-
Недопустимый тип кадра
-
87
Недопустимый тип кадра.
-
Недопустимый номер сети
-
88
Недопустимый номер сети.
-
Повторяющийся номер сети
-
89
Повторяющийся номер сети.
-
Параметр выходит за пределы границ
-
90
Параметр выходит за пределы.
-
Доступ запрещен
-
91
Доступ запрещен.
-
Недостаточно памяти
-
92
Недостаточно памяти.
-
Уже существует
-
93
Уже существует.
-
Путь, файл или объект не найден
-
94
Путь, файл или объект не найден.
-
Не удается уведомить службу
-
95
Не удается уведомить службу.
-
Не удается уведомить службу DNS
-
96
Не удается уведомить службу DNS.
-
Интерфейс не настраивается
-
97
Интерфейс не настраивается.
-
Не все аренды DHCP могут быть освобождены или продлены
-
98
Не все аренды DHCP могут быть освобождены или продлены.
-
Dhcp не включен в адаптере
-
100
Протокол DHCP не включен для адаптера.
-
Другое
-
101 4294967295
Комментарии
Если для WINSPrimaryServer и WINSSecondaryServer задано значение "" (пустая строка), то явные серверы WINS отменить изменения обратно в DHCP.
Примеры
Назначение IP-адреса, полученного из базы данных Пример кода VBScript ищет компьютер в базе данных и назначает ему указанный IP-адрес.
В следующем примере кода VBScript задается основной и дополнительный сервер WINS для сетевого адаптера, привязанного к TCP/IP.
On Error Resume Next
strComputer = "."
Set objWMIService = GetObject("winmgmts:" _
& "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colNetCards = objWMIService.ExecQuery _
("Select * From Win32_NetworkAdapterConfiguration Where IPEnabled = True")
For Each objNetCard in colNetCards
strPrimaryServer = "192.168.1.100"
strSecondaryServer = "192.168.1.200"
objNetCard.SetWINSServer strPrimaryServer, strSecondaryServer
Next
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Пространство имен |
Root\CIMV2 |
| MOF |
|
| DLL |
|