Класс CIM_NetworkAdapter

Статья
06/03/2023

Класс CIM_NetworkAdapter является абстрактным классом, определяющим общие понятия сетевого оборудования (например, постоянный адрес или скорость работы). Информация передается с помощью связи CIM_DeviceSAPImplementation .

Сетевые адаптеры и связанные конечные точки представляют собой потенциал для подключения между одноранговых узлов. Возможности подключения значительно отличаются от master, подчиненных и контроллеров или управляемых связей CIM_Controller. Однако иногда одно устройство выступает как сетевой адаптер и контроллер, например, когда адаптер оптоволоконного канала работает в качестве контроллера SCSI компьютерной системы. В этом случае аспекты устройства ориентированы на сеть, а другие — на контроллеры. Необходимо создать экземпляры классов контроллера и адаптера, а также создать связь удостоверений устройства, чтобы связать различные аспекты устройства.

Важно!

Классы CIM (Common Information Model) DMTF (Distributed Management Task Force) являются родительскими классами, на основе которых создаются классы WMI. В настоящее время WMI поддерживает только схемы версии CIM 2.x.

Приведенный ниже синтаксис является упрощенной версией кода MOF и включает все унаследованные свойства. Свойства перечислены в алфавитном порядке, а не в порядке MOF.

Синтаксис

[Abstract, UUID("{8502C532-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_NetworkAdapter : CIM_LogicalDevice
{
  boolean  AutoSense;
  uint16   Availability;
  string   Caption;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   Description;
  string   DeviceID;
  boolean  ErrorCleared;
  string   ErrorDescription;
  datetime InstallDate;
  uint32   LastErrorCode;
  uint64   MaxSpeed;
  string   Name;
  string   NetworkAddresses[];
  string   PermanentAddress;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  uint64   Speed;
  string   Status;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
};

Члены

Класс CIM_NetworkAdapter имеет следующие типы членов:

Методы
Свойства

Методы

Класс CIM_NetworkAdapter содержит следующие методы.

Метод	Описание
Reset	Запрашивает сброс логического устройства. Не реализован инструментарием WMI.
SetPowerState	Определяет требуемое состояние питания для логического устройства и время, когда устройство должно быть переведено в это состояние. Не реализован инструментарием WMI.

Свойства

Класс CIM_NetworkAdapter имеет следующие свойства.

Автозакзания

Тип данных: boolean
Тип доступа: только для чтения

Если значение РАВНО TRUE, сетевой адаптер может автоматически определить скорость или другие характеристики связи подключенного сетевого носителя.

Доступность

Тип данных: uint16
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| Рабочее состояние|003.5", "MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus")

Доступность и состояние устройства.

Это свойство наследуется от CIM_LogicalDevice.

Другое (1)

Неизвестно (2)

Работает/полная мощность (3)

Предупреждение (4)

В тесте (5)

Неприменимо (6)

Выключение питания (7)

Off Line (8)

Off Duty (9)

Пониженная производительность (10)

Не установлено (11)

Ошибка установки (12)

Энергосбережение — неизвестно (13)

Известно, что устройство находится в режиме энергопотребления, но его точное состояние неизвестно.

Экономия энергии — режим низкого энергопотребления (14)

Устройство находится в состоянии экономии электроэнергии, но по-прежнему работает и может демонстрировать снижение производительности.

Экономия энергии в режиме ожидания (15)

Устройство не работает, но может быть быстро приведено в полную мощность.

Цикл питания (16)

Экономия энергии — предупреждение (17)

Устройство находится в состоянии предупреждения, но также в режиме энергопотребления.

Приостановлено (18)

Устройство приостановлено.

Не готово (19)

Устройство не готово.

Не настроено (20)

Устройство не настроено.

Заморозка (21)

Устройство не работает.

Caption

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (64), DisplayName ("Caption")

Краткое текстовое описание объекта.

Это свойство наследуется от CIM_ManagedSystemElement.

ConfigManagerErrorCode

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: Schema ("Win32")

Код ошибки Configuration Manager Windows.

Это свойство наследуется от CIM_LogicalDevice.

Это устройство работает правильно. (0)

Устройство работает правильно.

Это устройство настроено неправильно. (1)

Устройство настроено неправильно.

Windows не может загрузить драйвер для этого устройства. (2)

Драйвер для этого устройства может быть поврежден или в системе может быть недостаточно памяти или других ресурсов. (3)

Драйвер для этого устройства может быть поврежден или в системе может быть недостаточно памяти или других ресурсов.

Это устройство работает неправильно. Один из его драйверов или реестр может быть поврежден. (4)

Устройство работает неправильно. Один из его драйверов или реестр может быть поврежден.

Драйверу для этого устройства требуется ресурс, которым Windows не может управлять. (5)

Драйверу для устройства требуется ресурс, которым Windows не может управлять.

Конфигурация загрузки для этого устройства конфликтует с другими устройствами. (6)

Конфигурация загрузки для устройства конфликтует с другими устройствами.

Не удается выполнить фильтрацию. (7)

Отсутствует загрузчик драйверов для устройства. (8)

Отсутствует загрузчик драйвера для устройства.

Это устройство работает неправильно, так как управляющее встроенное ПО неправильно сообщает о ресурсах для устройства. (9)

Устройство работает неправильно; управляющее встроенное ПО неправильно сообщает о ресурсах для устройства.

Не удается запустить это устройство. (10)

Не удается запустить устройство.

Это устройство завершилось сбоем. (11)

Сбой устройства.

Это устройство не может найти достаточно свободных ресурсов, которые оно может использовать. (12)

Устройство не может найти достаточно свободных ресурсов для использования.

Windows не может проверить ресурсы этого устройства. (13)

Windows не может проверить ресурсы устройства.

Это устройство не может работать должным образом, пока вы не перезагрузите компьютер. (14)

Устройство не может работать должным образом, пока компьютер не перезагрузится.

Это устройство работает неправильно, так как, вероятно, возникла проблема с повторным перечислением. (15)

Устройство не работает должным образом из-за возможной проблемы с повторным перечислением.

Windows не может определить все ресурсы, используемые этим устройством. (16)

Windows не может определить все ресурсы, используемые устройством.

Это устройство запрашивает неизвестный тип ресурса. (17)

Устройство запрашивает неизвестный тип ресурса.

Переустановите драйверы для этого устройства. (18)

Драйверы устройств необходимо переустановить.

Сбой при использовании загрузчика VxD. (19)

Возможно, реестр поврежден. (20)

Реестр может быть поврежден.

Сбой системы. Попробуйте изменить драйвер для этого устройства. Если это не сработает, обратитесь к документации по оборудованию. Windows удаляет это устройство. (21)

Сбой системы. Если изменение драйвера устройства неэффективно, см. документацию по оборудованию. Windows удаляет устройство.

Это устройство отключено. (22)

Устройство отключено.

Сбой системы. Попробуйте изменить драйвер для этого устройства. Если это не сработает, обратитесь к документации по оборудованию. (23)

Сбой системы. Если изменение драйвера устройства неэффективно, см. документацию по оборудованию.

Это устройство отсутствует, не работает должным образом или на нем установлены не все драйверы. (24)

Устройство отсутствует, не работает должным образом или на нем установлены не все драйверы.

Windows по-прежнему настраивает это устройство. (25)

Windows по-прежнему настраивает устройство.

Windows по-прежнему настраивает это устройство. (26)

Windows по-прежнему настраивает устройство.

Это устройство не имеет допустимой конфигурации журнала. (27)

Устройство не имеет допустимой конфигурации журнала.

Драйверы для этого устройства не установлены. (28)

Драйверы устройств не установлены.

Это устройство отключено, так как встроенное ПО устройства не дало ему необходимых ресурсов. (29)

Устройство отключено; встроенное ПО устройства не предоставило необходимых ресурсов.

Это устройство использует ресурс запроса прерывания (IRQ), который использует другое устройство. (30)

Устройство использует ресурс IRQ, который использует другое устройство.

Это устройство работает неправильно, так как Windows не может загрузить драйверы, необходимые для этого устройства. (31)

Устройство работает неправильно; Windows не может загрузить необходимые драйверы устройств.

ConfigManagerUserConfig

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: Schema ("Win32")

Если задано значение TRUE, устройство использует определяемую пользователем конфигурацию.

Это свойство наследуется от CIM_LogicalDevice.

CreationClassName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: CIM_Key

Имя класса или подкласса, используемого при создании экземпляра. При использовании с другими ключевыми свойствами класса это свойство позволяет уникально идентифицировать все экземпляры класса и его подклассы.

Это свойство наследуется от CIM_LogicalDevice.

Описание

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Описание")

Текстовое описание объекта.

Это свойство наследуется от CIM_ManagedSystemElement.

DeviceID

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: CIM_Key

Адрес или другие идентифицирующие сведения для уникального имени логического устройства.

Это свойство наследуется от CIM_LogicalDevice.

ErrorCleared

Тип данных: boolean
Тип доступа: только для чтения

Если задано значение TRUE, ошибка, обнаруженная в свойстве LastErrorCode , теперь очищается.

Это свойство наследуется от CIM_LogicalDevice.

ErrorDescription

Тип данных: string
Тип доступа: только для чтения

Строка свободной формы, которая предоставляет сведения об ошибке, записанной в свойстве LastErrorCode , и корректирующие действия, которые необходимо выполнить.

Это свойство наследуется от CIM_LogicalDevice.

InstallDate

Тип данных: datetime
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Дата установки")

Дата и время установки объекта. Этому свойству не требуется значение, указывающее, что объект установлен.

Это свойство наследуется от CIM_ManagedSystemElement.

LastErrorCode

Тип данных: uint32
Тип доступа: только для чтения

Последний код ошибки, сообщаемый логическим устройством.

Это свойство наследуется от CIM_LogicalDevice.

MaxSpeed

Тип данных: uint64
Тип доступа: только для чтения
Квалификаторы: единицы ("бит в секунду")

Максимальная скорость (в битах в секунду) для сетевого адаптера.

Дополнительные сведения об использовании значений uint64 в скриптах см. в разделе Скрипты в WMI.

имя;

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Name")

Метка, по которой известен объект. При подклассе это свойство может быть переопределено как ключевое свойство.

Это свойство наследуется от CIM_ManagedSystemElement.

NetworkAddresses

Тип данных: строковый массив
Тип доступа: только для чтения
Квалификаторы: MaxLen (64), MappingStrings ("MIF. DMTF| Порт 802 сетевого адаптера|001.3")

Список сетевых адресов для адаптера.

PermanentAddress

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (64), MappingStrings ("MIF. DMTF| Порт 802 сетевого адаптера|001.2")

Сетевой адрес жестко закодирован в адаптере. Жестко заданный адрес можно изменить с помощью обновления встроенного ПО или конфигурации программного обеспечения. При изменении поле должно быть обновлено при изменении. Это свойство следует оставить пустым, если для сетевого адаптера не существует жестко закодированного адреса.

PNPDeviceID

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Схема ("Win32")

Win32 Plug and Play идентификатор логического устройства. Это свойство наследуется от CIM_LogicalDevice.

Пример: "*PNP030b"

PowerManagementCapabilities

Тип данных: массив uint16
Тип доступа: только для чтения

Массив конкретных возможностей логического устройства, связанных с питанием.

Это свойство наследуется от CIM_LogicalDevice.

Неизвестно (0)

Не поддерживается (1)

Отключено (2)

Включено (3)

Функции управления питанием в настоящее время включены, но точный набор функций неизвестен или информация недоступна.

Режимы энергосбережения, введенные автоматически (4)

Устройство может изменять состояние питания в зависимости от использования или других критериев.

Настройка состояния power (5)

Поддерживается метод SetPowerState . Этот метод находится в родительском CIM_LogicalDevice классе и может быть реализован. Дополнительные сведения см. в разделе Designing Managed Object Format (MOF) Classes.

Поддержка циклов питания (6)

Метод SetPowerState можно вызвать с параметром PowerState , равным 5 (Power Cycle).

Поддержка включения по времени (7)

Метод SetPowerState можно вызвать с параметром PowerState , равным 5 (power cycle), а для параметра Time задана определенная дата и время или интервал для включения питания.

PowerManagementSupported

Тип данных: boolean
Тип доступа: только для чтения

Если задано значение TRUE, устройством можно управлять питанием, то есть переводить в состояние экономии энергии. Если значение FALSE, целочисленное значение 1 ("Не поддерживается") должно быть единственной записью в массиве PowerManagementCapabilities .

Это свойство не указывает, включены ли в настоящее время функции управления питанием или, если они включены, какие функции поддерживаются. Дополнительные сведения см. в статье Массив PowerManagementCapabilities . Это свойство наследуется от CIM_LogicalDevice.

Скорость

Тип данных: uint64
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIB. IETF| RFC1213-MIB.ifSpeed", "MIF. DMTF| Порт сетевого адаптера 802|001.5), единицы измерения (бит в секунду)

Оценка текущей пропускной способности в BPS. Для конечных точек, которые различаются по пропускной способности, или для конечных точек, для которых не может быть сделана точная оценка, это свойство должно содержать номинальную пропускную способность.

Дополнительные сведения об использовании значений uint64 в скриптах см. в разделе Скрипты в WMI.

Состояние

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (10), DisplayName ("Status")

Текущее состояние объекта.

Это свойство наследуется от CIM_ManagedSystemElement.

В эти значения входят:

ОК ("ОК")

Ошибка ("Ошибка")

Пониженный ("Пониженный")

Unknown ("Unknown")

Pred Fail ("Pred Fail")

Запуск ("Начало")

Остановка ("Остановка")

Служба ("Служба")

Подчеркнуто ("Подчеркнуто")

NonRecover ("NonRecover")

Нет контакта ("Нет контакта")

Lost Comm ("Lost Comm")

StatusInfo

Тип данных: uint16
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| Рабочее состояние|003.3")

Состояние логического устройства. Если это свойство не применяется к логическому устройству, следует использовать значение 5 (неприменимо).

Это свойство наследуется от CIM_LogicalDevice.

Другое (1)

Неизвестно (2)

Включено (3)

Отключено (4)

Неприменимо (5)

SystemCreationClassName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: распространяется ("CIM_System. CreationClassName"), CIM_Key

Имя класса создания системы области.

Это свойство наследуется от CIM_LogicalDevice.

SystemName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: распространяется ("CIM_System. Name"), CIM_Key

Имя системы определения области.

Это свойство наследуется от CIM_LogicalDevice.

Эта документация является производным от описаний классов CIM, опубликованных DMTF. Возможно, корпорация Майкрософт внесла изменения для исправления незначительных ошибок, соответствия стандартам документации по Microsoft SDK или предоставления дополнительных сведений.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Пространство имен	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

См. также раздел

CIM_LogicalDevice

Поделиться через

Класс CIM_NetworkAdapter

Синтаксис

Члены

Методы

Свойства

Комментарии

Требования

См. также раздел

Обратная связь

Дополнительные ресурсы