Classe Win32_NetworkConnection

Artigo
06/12/2023

A classe WMIWin32_NetworkConnection representa uma conexão de rede ativa em um ambiente baseado no Windows.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. Propriedades e métodos estão em ordem alfabética, não em ordem MOF.

Sintaxe

[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;
};

Membros

A classe Win32_NetworkConnection tem estes tipos de membros:

Propriedades

Propriedades

A classe Win32_NetworkConnection tem essas propriedades.

AccessMask

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: Esquema ("Win32")

Lista de direitos de acesso para o arquivo ou diretório determinado mantido pelo usuário ou grupo em cujo nome a instância é retornada. Em volumes FAT, o valor FULL_ACCESS é retornado, indicando que nenhuma segurança foi definida no objeto.

FILE_READ_DATA (arquivo) ou FILE_LIST_DIRECTORY (diretório) (1)

Concede o direito de ler dados do arquivo. Para um diretório, esse valor concede o direito de listar o conteúdo do diretório.

FILE_WRITE_DATA (arquivo) ou FILE_ADD_FILE (diretório) (2)

Concede o direito de gravar dados no arquivo. Para um diretório, esse valor concede o direito de criar um arquivo no diretório .

FILE_APPEND_DATA (arquivo) ou FILE_ADD_SUBDIRECTORY (4)

Concede o direito de acrescentar dados ao arquivo. Para um diretório, esse valor concede o direito de criar um subdiretório.

FILE_READ_EA (8)

Concede o direito de ler atributos estendidos.

FILE_WRITE_EA (16)

Concede o direito de gravar atributos estendidos.

FILE_EXECUTE (arquivo) ou FILE_TRAVERSE (diretório) (32)

Concede o direito de executar um arquivo. Para um diretório, o diretório pode ser percorrido.

FILE_DELETE_CHILD (diretório) (64)

Concede o direito de excluir um diretório e todos os arquivos que ele contém (seus filhos), mesmo que os arquivos sejam somente leitura.

FILE_READ_ATTRIBUTES (128)

Concede o direito de ler atributos de arquivo.

FILE_WRITE_ATTRIBUTES (256)

Concede o direito de alterar atributos de arquivo.

DELETE (65536)

Concede acesso de exclusão.

READ_CONTROL (131072)

Concede acesso de leitura ao descritor de segurança e ao proprietário.

WRITE_DAC (262144)

Concede acesso de gravação à DACL (lista de controle de acesso discricionário).

WRITE_OWNER (524288)

Atribui o proprietário da gravação.

SYNCHRONIZE (1048576)

Sincroniza o acesso e permite que um processo aguarde até que um objeto entre no estado sinalizado.

Legenda

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MaxLen (64), DisplayName ("Caption")

Uma breve descrição textual do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Comentário

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32API| Estruturas de rede do Windows | NETRESOURCE|lpComment")

Comentário fornecido pelo provedor de rede.

Connectionstate

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MaxLen (20), MappingStrings ("Win32API| Estruturas de gerenciamento de rede| | USE_INFO_1 ui1_status")

Estado atual da conexão de rede.

Conectado ("Conectado")

Erro ("Erro")

Pausado ("Pausado")

Desconectado ("Desconectado")

Conectando ("Conectando")

Reconectando ("Reconectando")

ConnectionType

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32API| Estruturas de rede do Windows | NETRESOURCE|dwScope")

Tipo de persistência da conexão usada para se conectar à rede.

Conexão Atual ("Conexão Atual")

Conexão Persistente ("Conexão Persistente")

Descrição

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Description")

Uma descrição textual do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

DisplayType

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32API| Estruturas de rede do Windows | NETRESOURCE|dwDisplayType")

O objeto de rede deve ser exibido em uma interface do usuário de navegação de rede.

Domínio ("Domínio")

Genérico ("Genérico")

Servidor ("Servidor")

Compartilhar ("Compartilhar")

InstallDate

Tipo de dados: datetime
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Data de Instalação")

Indica quando o objeto foi instalado. A falta de um valor não indica que o objeto não está instalado.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Localname

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32API| Estruturas de rede do Windows| NETRESOURCE|lpLocalName")

Nome local do dispositivo de rede conectado.

Exemplo: "c:\public"

Nome

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: key, Override ("Name"), MappingStrings ("Win32API| Estruturas de rede do Windows| NETRESOURCE")

Nome da conexão de rede atual. É a combinação dos valores em RemoteName e LocalName.

Exemplo: "\\NTRELEASE (c:\public)"

Persistente

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32API| Funções de rede do Windows| WNetEnumResource")

A conexão será reconectada automaticamente pelo sistema operacional no próximo logon.

ProviderName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32API| Estruturas de rede do Windows| NETRESOURCE|lpProvider")

Nome do provedor que possui o recurso. Essa propriedade poderá ser NULL se o nome do provedor for desconhecido.

RemoteName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32API| Estruturas de rede do Windows| NETRESOURCE|lpRemoteName")

Nome do recurso de rede remota para um recurso de rede. Para uma conexão atual ou persistente, RemoteName contém o nome de rede associado ao nome do valor na propriedade LocalName . O nome em RemoteName deve seguir as convenções de nomenclatura do provedor de rede.

Exemplo: "\\NTRELEASE"

RemotePath

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32API| Estruturas de rede do Windows| NETRESOURCE|lpRemoteName")

Caminho completo para o recurso de rede.

Exemplo: "\\infosrv1\public"

ResourceType

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32API| Estruturas de rede do Windows| NETRESOURCE|dwType")

Tipo de recurso ao qual enumerar ou se conectar.

Disco ("Disco")

Imprimir ("Imprimir")

Any ("Any")

Status

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MaxLen (10), DisplayName ("Status")

Cadeia de caracteres que indica o status atual do objeto. As status operacionais e não operacionais podem ser definidas. Os status operacionais podem incluir "OK", "Degradado" e "Falha de Pred". "Pred Fail" indica que um elemento está funcionando corretamente, mas está prevendo uma falha (por exemplo, uma unidade de disco rígido habilitada para SMART).

As status não operacionais podem incluir "Erro", "Iniciando", "Parando" e "Serviço". O "Serviço" pode ser aplicado durante o disco espelho-resilvering, recarregando uma lista de permissões de usuário ou outro trabalho administrativo. Nem todo esse trabalho está online, mas o elemento gerenciado não é "OK" nem em um dos outros estados.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Os valores incluem o seguinte:

OK ("OK")

Erro ("Erro")

Degradado ("Degradado")

Desconhecido ("Desconhecido")

Falha de pred ("Falha de pred")

Iniciando ("Iniciando")

Parando ("Parando")

Serviço ("Serviço")

Estressado ("Estressado")

NonRecover ("NonRecover")

Sem contato ("Sem contato")

Comm Perdido ("Comm Perdido")

UserName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("Win32API| Funções de rede do Windows| WNetGetUser")

Nome de usuário ou o nome de usuário padrão usado para estabelecer uma conexão de rede.

Exemplo: "SYSTEM"

Comentários

A classe Win32_NetworkConnection é derivada de CIM_LogicalElement.

Exemplos

O exemplo de código VBScript a seguir recupera informações sobre a conexão de rede local.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Confira também

CIM_LogicalElement
Classes do sistema operacional

Compartilhar via

Classe Win32_NetworkConnection

Sintaxe

Membros

Propriedades

Comentários

Exemplos

Requisitos

Confira também

Comentários

Recursos adicionais