Win32_NetworkConnection clase
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
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 |
|
| Archivo DLL |
|
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de