класс Win32_NetworkConnection

Статья
06/12/2023

Класс WMIWin32_NetworkConnection представляет активное сетевое подключение в среде windows.

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

Синтаксис

[Dynamic, Provider("CIMWin32"), UUID("{8502C4CD-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_NetworkConnection : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Status;
  uint32   AccessMask;
  string   Comment;
  string   ConnectionState;
  string   ConnectionType;
  string   DisplayType;
  string   LocalName;
  string   Name;
  boolean  Persistent;
  string   ProviderName;
  string   RemoteName;
  string   RemotePath;
  string   ResourceType;
  string   UserName;
};

Члены

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

Свойства

Элемент Property

Класс Win32_NetworkConnection имеет эти свойства.

AccessMask

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

Список прав доступа к заданному файлу или каталогу, которые хранятся у пользователя или группы, от имени которых возвращается экземпляр. На томах FAT вместо этого возвращается значение FULL_ACCESS , указывающее, что для объекта не задана безопасность.

FILE_READ_DATA (файл) или FILE_LIST_DIRECTORY (каталог) (1)

Предоставляет право на чтение данных из файла. Для каталога это значение дает право на перечисление содержимого каталога.

FILE_WRITE_DATA (файл) или FILE_ADD_FILE (каталог) (2)

Предоставляет право записывать данные в файл. Для каталога это значение дает право создавать файл в каталоге.

FILE_APPEND_DATA (файл) или FILE_ADD_SUBDIRECTORY (4)

Предоставляет право добавлять данные в файл. Для каталога это значение предоставляет право на создание подкаталога.

FILE_READ_EA (8)

Предоставляет право на чтение расширенных атрибутов.

FILE_WRITE_EA (16)

Предоставляет право на запись расширенных атрибутов.

FILE_EXECUTE (файл) или FILE_TRAVERSE (каталог) (32)

Предоставляет право на выполнение файла. Для каталога можно просмотреть каталог.

FILE_DELETE_CHILD (каталог) (64)

Предоставляет право удалять каталог и все содержащиеся в нем файлы (его дочерние элементы), даже если файлы доступны только для чтения.

FILE_READ_ATTRIBUTES (128)

Предоставляет право на чтение атрибутов файла.

FILE_WRITE_ATTRIBUTES (256)

Предоставляет право изменять атрибуты файла.

DELETE (65536)

Предоставляет доступ к удалению.

READ_CONTROL (131072)

Предоставляет доступ на чтение дескриптору безопасности и владельцу.

WRITE_DAC (262144)

Предоставляет доступ на запись к списку управления доступом на уровне пользователей (DACL).

WRITE_OWNER (524288)

Назначает владельца записи.

SYNCHRONIZE (1048576)

Синхронизирует доступ и позволяет процессу ожидать, пока объект перейдет в состояние сигнала.

Caption

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

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

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

Комментарий

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| | Сетевые структуры Windows | NETRESOURCE|lpComment")

Комментарий, предоставленный поставщиком сети.

ConnectionState

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (20), MappingStrings ("Win32API| Структуры управления сетями | | USE_INFO_1 ui1_status")

Текущее состояние сетевого подключения.

Connected ("Connected")

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

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

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

Подключение ("Подключение")

Повторное подключение ("Повторное подключение")

ConnectionType

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| | Сетевые структуры Windows | NETRESOURCE|dwScope")

Тип сохраняемости подключения, используемого для подключения к сети.

Текущее подключение ("Текущее подключение")

Постоянное подключение ("постоянное подключение")

Описание

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

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

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

DisplayType

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| | Сетевые структуры Windows | NETRESOURCE|dwDisplayType")

Сетевой объект должен отображаться в пользовательском интерфейсе просмотра сети.

Домен ("Домен")

Generic ("Generic")

Сервер ("Сервер")

Общий доступ ("Общий доступ")

InstallDate

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

Указывает, когда был установлен объект . Отсутствие значения не означает, что объект не установлен.

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

LocalName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Сетевые структуры Windows | NETRESOURCE|lpLocalName")

Локальное имя подключенного сетевого устройства.

Пример: "c:\public"

имя;

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: key, Override ("Name"), MappingStrings ("Win32API| | Сетевые структуры Windows | NETRESOURCE")

Имя текущего сетевого подключения. Это сочетание значений в RemoteName и LocalName.

Пример: \\NTRELEASE (c:\public)"

Persistent

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Сетевые функции Windows | WNetEnumResource")

Подключение будет автоматически повторно установлено операционной системой при следующем входе в систему.

ProviderName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Сетевые структуры Windows | NETRESOURCE|lpProvider")

Имя поставщика, которому принадлежит ресурс. Это свойство может иметь значение NULL , если имя поставщика неизвестно.

RemoteName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Сетевые структуры Windows | NETRESOURCE|lpRemoteName")

Имя удаленного сетевого ресурса для сетевого ресурса. Для текущего или постоянного подключения RemoteName содержит сетевое имя, связанное с именем значения в свойстве LocalName . Имя в RemoteName должно соответствовать соглашениям об именовании поставщика сети.

Пример: "\\NTRELEASE"

RemotePath

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Сетевые структуры Windows | NETRESOURCE|lpRemoteName")

Полный путь к сетевому ресурсу.

Пример: "\\infosrv1\public"

ResourceType

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Сетевые структуры Windows | NETRESOURCE|dwType")

Тип ресурса для перечисления или подключения.

Диск ("Диск")

Print ("Печать")

Any ("Любой")

Состояние

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

Строка, указывающая текущее состояние объекта. Можно определить рабочее и нерабочее состояние. Состояние работы может включать "ОК", "Понижено" и "Сбой pred". "Pred Fail" указывает, что элемент работает правильно, но прогнозирует сбой (например, жесткий диск с поддержкой SMART).

Состояние "Нерабочее" может включать "Ошибка", "Запуск", "Остановка" и "Служба". "Служба" может применяться во время повторного зеркало диска, перезагрузки списка разрешений пользователя или выполнения других административных действий. Не вся такая работа находится в сети, но управляемый элемент не является ни "ОК", ни в одном из других состояний.

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

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

ОК ("ОК")

Error ("Error")

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

Unknown ("Unknown")

Pred Fail ("Pred Fail")

Запуск ("Запуск")

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

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

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

NonRecover ("NonRecover")

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

Lost Comm ("Lost Comm")

UserName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Сетевые функции Windows | WNetGetUser")

Имя пользователя или имя пользователя по умолчанию, используемое для установки сетевого подключения.

Пример: "SYSTEM"

Примеры

В следующем примере кода VBScript извлекаются сведения о локальном сетевом подключении.

On Error Resume Next
strComputer = "."
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\Root\CIMv2")
Set colItems = objWMIService.ExecQuery("Select * from Win32_NetworkConnection",,48)
For Each objItem in colItems
    Wscript.Echo "AccessMask: " & objItem.AccessMask
    Wscript.Echo "Caption: " & objItem.Caption
    Wscript.Echo "Comment: " & objItem.Comment
    Wscript.Echo "ConnectionState: " & objItem.ConnectionState
    Wscript.Echo "ConnectionType: " & objItem.ConnectionType
    Wscript.Echo "Description: " & objItem.Description
    Wscript.Echo "DisplayType: " & objItem.DisplayType
    Wscript.Echo "InstallDate: " & objItem.InstallDate
    Wscript.Echo "LocalName: " & objItem.LocalName
    Wscript.Echo "Name: " & objItem.Name
    Wscript.Echo "Persistent: " & objItem.Persistent
    Wscript.Echo "ProviderName: " & objItem.ProviderName
    Wscript.Echo "RemoteName: " & objItem.RemoteName
    Wscript.Echo "RemotePath: " & objItem.RemotePath
    Wscript.Echo "ResourceType: " & objItem.ResourceType
    Wscript.Echo "Status: " & objItem.Status
    Wscript.Echo "UserName: " & objItem.UserName
Next

Требования

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

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

CIM_LogicalElement
Классы операционной системы

класс Win32_NetworkConnection

Синтаксис

Члены

Элемент Property

Комментарии

Примеры

Требования

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

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

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

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