Win32_NetworkConnection clase

Artículo
06/12/2023

La clase WMI de Win32_NetworkConnectionrepresenta una conexión de red activa en un entorno basado en Windows.

La siguiente sintaxis se simplifica desde el código de Managed Object Format (MOF) e incluye todas las propiedades heredadas. Las propiedades y los métodos están en orden alfabético, no en orden MOF.

Sintaxis

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

Miembros

La clase Win32_NetworkConnection tiene estos tipos de miembros:

Propiedades

Propiedades

La clase Win32_NetworkConnection tiene estas propiedades.

AccessMask

Tipo de datos: uint32
Tipo de acceso: solo lectura
Calificadores: Esquema ("Win32")

Lista de derechos de acceso al archivo o directorio especificados mantenidos por el usuario o grupo en cuyo nombre se devuelve la instancia. En los volúmenes FAT, el valor de FULL_ACCESS se devuelve en su lugar, lo que indica que no se ha establecido ninguna seguridad en el objeto .

FILE_READ_DATA (archivo) o FILE_LIST_DIRECTORY (directorio) ( 1)

Concede el derecho a leer datos del archivo. Para un directorio, este valor concede el derecho a enumerar el contenido del directorio.

FILE_WRITE_DATA (archivo) o FILE_ADD_FILE (directorio) ( 2)

Concede el derecho de escribir datos en el archivo. Para un directorio, este valor concede el derecho a crear un archivo en el directorio.

FILE_APPEND_DATA (archivo) o FILE_ADD_SUBDIRECTORY (4)

Concede el derecho de anexar datos al archivo. Para un directorio, este valor concede el derecho a crear un subdirectorio.

FILE_READ_EA (8)

Concede el derecho a leer atributos extendidos.

FILE_WRITE_EA (16)

Concede el derecho a escribir atributos extendidos.

FILE_EXECUTE (archivo) o FILE_TRAVERSE (directorio) ( 32)

Concede el derecho de ejecutar un archivo. Para un directorio, se puede recorrer el directorio.

FILE_DELETE_CHILD (directorio) ( 64)

Concede el derecho a eliminar un directorio y todos los archivos que contiene (sus elementos secundarios), incluso si los archivos son de solo lectura.

FILE_READ_ATTRIBUTES (128)

Concede el derecho a leer atributos de archivo.

FILE_WRITE_ATTRIBUTES (256)

Concede el derecho a cambiar los atributos de archivo.

DELETE (65536)

Concede acceso de eliminación.

READ_CONTROL (131072)

Concede acceso de lectura al descriptor de seguridad y al propietario.

WRITE_DAC (262144)

Concede acceso de escritura a la lista de control de acceso discrecional (DACL).

WRITE_OWNER (524288)

Asigna el propietario de escritura.

SYNCHRONIZE (1048576)

Sincroniza el acceso y permite que un proceso espere a que un objeto entre en el estado señalado.

Caption

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MaxLen (64), DisplayName ("Caption")

Una breve descripción textual del objeto.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Comment

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32API| Estructuras de redes de Windows | NETRESOURCE|lpComment")

Comentario proporcionado por el proveedor de red.

ConnectionState

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MaxLen (20), MappingStrings ("Win32API| Estructuras de administración de red | | USE_INFO_1 ui1_status")

Estado actual de la conexión de red.

Conectado ("Conectado")

Error ("Error")

En pausa ("En pausa")

Desconectado ("Desconectado")

Conexión ("Conexión")

Reconexión ("Reconexión")

ConnectionType

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32API| Estructuras de redes de Windows | NETRESOURCE|dwScope")

Tipo de persistencia de la conexión utilizada para conectarse a la red.

Conexión actual ("Conexión actual")

Conexión persistente ("Conexión persistente")

Descripción

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: DisplayName ("Descripción")

Descripción textual del objeto.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Displaytype

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32API| Estructuras de redes de Windows | NETRESOURCE|dwDisplayType")

El objeto de red debe mostrarse en una interfaz de usuario de exploración de red.

Dominio ("Dominio")

Genérico ("Genérico")

Servidor ("Servidor")

Compartir ("Compartir")

InstallDate

Tipo de datos: datetime
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Fecha de instalación")

Indica cuándo se instaló el objeto. La falta de un valor no indica que el objeto no está instalado.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Localname

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32API| Estructuras de redes de Windows | NETRESOURCE|lpLocalName")

Nombre local del dispositivo de red conectado.

Ejemplo: "c:\public"

Nombre

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: key, Override ("Name"), MappingStrings ("Win32API| Estructuras de redes de Windows | NETRESOURCE")

Nombre de la conexión de red actual. Es la combinación de los valores de RemoteName y LocalName.

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

Persistent

Tipo de datos: booleano
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32API| Funciones de red de Windows| WNetEnumResource")

El sistema operativo volverá a conectar automáticamente la conexión en el siguiente inicio de sesión.

ProviderName

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32API| Estructuras de redes de Windows | NETRESOURCE|lpProvider")

Nombre del proveedor que posee el recurso. Esta propiedad puede ser NULL si se desconoce el nombre del proveedor.

RemoteName

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32API| Estructuras de redes de Windows | NETRESOURCE|lpRemoteName")

Nombre del recurso de red remoto para un recurso de red. Para una conexión actual o persistente, RemoteName contiene el nombre de red asociado al nombre del valor en la propiedad LocalName . El nombre de RemoteName debe seguir las convenciones de nomenclatura del proveedor de red.

Ejemplo: "\\NTRELEASE"

RemotePath

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32API| Estructuras de redes de Windows | NETRESOURCE|lpRemoteName")

Ruta de acceso completa al recurso de red.

Ejemplo: "\\infosrv1\public"

ResourceType

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32API| Estructuras de redes de Windows | NETRESOURCE|dwType")

Tipo de recurso al que se va a enumerar o conectarse.

Disco ("Disco")

Imprimir ("Imprimir")

Any ("Any")

Estado

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MaxLen (10), DisplayName ("Status")

Cadena que indica el estado actual del objeto. Se puede definir el estado operativo y no operativo. El estado operativo puede incluir "Ok", "Degradado" y "Error previo". "Error previo" indica que un elemento funciona correctamente, pero predice un error (por ejemplo, una unidad de disco duro habilitada para SMART).

El estado no operativo puede incluir "Error", "Inicio", "Detención" y "Servicio". "Servicio" se puede aplicar durante la resilveración de reflejo del disco, la recarga de una lista de permisos de usuario u otro trabajo administrativo. No todo este trabajo está en línea, pero el elemento administrado no es "Correcto" ni en uno de los otros estados.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Los valores son los siguientes:

Ok ("OK")

Error ("Error")

Degradado ("Degradado")

Desconocido ("Desconocido")

Error previo ("Error previo")

Inicio ("Inicio")

Detener ("Detener")

Servicio ("Servicio")

Estresado ("Estresado")

NonRecover ("NonRecover")

Sin contacto ("Sin contacto")

Lost Comm ("Lost Comm")

UserName

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32API| Funciones de red de Windows| WNetGetUser")

Nombre de usuario o nombre de usuario predeterminado usado para establecer una conexión de red.

Ejemplo: "SYSTEM"

Comentarios

La clase Win32_NetworkConnection se deriva de CIM_LogicalElement.

Ejemplos

El siguiente ejemplo de código VBScript recupera información sobre la conexión de red 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	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Espacio de nombres	Root\CIMV2
MOF	CIMWin32.mof
Archivo DLL	CIMWin32.dll

Consulte también

CIM_LogicalElement
Clases de sistema operativo

Compartir a través de

Win32_NetworkConnection clase

Sintaxis

Miembros

Propiedades

Comentarios

Ejemplos

Requisitos

Consulte también

Comentarios

Recursos adicionales