BACK TO INDEX

Win32_NetworkConnection
The Win32_NetworkConnection class represents an active network connection in a Win32 environment.
NameSpace Path
\ROOT\CIMV2
PROPERTYSMS_REPORTCIMTYPEDESCRIPTION
AccessMaskUInt32The AccessMask property is a bit array representing the access rights as set remotely on the network share held by the user or group on whose behalf the instance is returned. This property is only supported under Windows NT and Windows 2000.
CaptionStringThe Caption property is a short textual description (one-line string) of the object.
CommentStringThe Comment property contains a comment supplied by the network provider.
ConnectionStateStringThe ConnectionState property indicates the current state of the network connection.
ConnectionTypeStringThe ConnectionType property indicates the persistence type of the connection used for connecting to the network. Example: Permanent.
DescriptionStringThe Description property provides a textual description of the object.
DisplayTypeStringThe DisplayType property indicates how the network object should be displayed in a network browsing user interface. Example: Generic.
InstallDateDateTimeThe InstallDate property is datetime value indicating when the object was installed. A lack of a value does not indicate that the object is not installed.
LocalNameStringThe LocalName property indicates the local name of the connected network device. Example: c:\public.
NameStringThe Name property indicates the name of the current network connection. It is the combination of the value in the RemoteName property and the value in the LocalName property. Example: \\NTRELEASE (c:\public).
PersistentBooleanThe Persistent property determines whether this connection will be reconnected automatically by the operating system on the next logon. Values: TRUE or FALSE. A value of TRUE indicates the network connection will be automatically connected.
ProviderNameStringThe ProviderName property contains the name of the provider that owns the resource. This property can be NULL if the provider name is unknown.
RemoteNameStringThe RemoteName property contains the remote network resource name for a network resource. For a current or persistent connection, RemoteName contains the network name associated with the name of the value in the LocalName property. The name in RemoteName must follow the network provider's naming conventions. Example: \\NTRELEASE.
RemotePathStringThe RemotePath property contains the full path to the network resource. Example: \\infosrv1\public
ResourceTypeStringThe ResourceType property identifies the type of resource to enumerate or connect to.
StatusStringThe Status property is a string indicating the current status of the object. Various operational and non-operational statuses can be defined. Operational statuses are "OK", "Degraded" and "Pred Fail". "Pred Fail" indicates that an element may be functioning properly but predicting a failure in the near future. An example is a SMART-enabled hard drive. Non-operational statuses can also be specified. These are "Error", "Starting", "Stopping" and "Service". The latter, "Service", could apply during mirror-resilvering of a disk, reload of a user permissions list, or other administrative work. Not all such work is on-line, yet the managed element is neither "OK" nor in one of the other states.
UserNameStringThe UserName property contains the user name or the default user name used to establish a network connection. Example: SYSTEM.
SAMPLE DATA INSTANCE
   [LOCALE(1033): ToInstance Amended]
   instance of Win32_NetworkConnection
   {
    AccessMask = 2032127;
    Caption = "RESOURCE REMEMBERED";
    Comment = " ";
    ConnectionState = "Connected";
    ConnectionType = "Persistent Connection";
    Description = "RESOURCE REMEMBERED - Microsoft Windows Network";
    DisplayType = "Share";
    LocalName = "o:";
    Name = "\\\\MRBIG\\@HOME\\EVERYONE$ (o:)";
    Persistent = TRUE;
    ProviderName = "Microsoft Windows Network";
    RemoteName = "\\\\MRBIG\\@HOME\\EVERYONE$";
    RemotePath = "\\\\MRBIG\\@HOME\\EVERYONE$";
    ResourceType = "Disk";
    Status = "OK";
    UserName = "DUDEWORKS\\administrator";
   };