OPC Studio User's Guide and Reference
MachineName Property (_ObjectDescriptor)



OpcLabs.BaseLib Assembly > OpcLabs.BaseLib.ComTypes Namespace > _ObjectDescriptor Interface : MachineName Property
Name of the machine. Determines the computer on which the object is located. It may be an empty string, in which case the object is assumed to exist on the local computer or at the computer specified for it by DCOM configuration.
Syntax
'Declaration
 
<NotNullAttribute()>
Property MachineName As String
'Usage
 
Dim instance As _ObjectDescriptor
Dim value As String
 
instance.MachineName = value
 
value = instance.MachineName
[NotNull()]
string MachineName {get; set;}
[NotNull()]
property String^ MachineName {
   String^ get();
   void set (    String^ value);
}

Property Value

The value represents a UNC or DNS computer name. The property value can be any string, but not all values make sense and will work when an operation using them is attempted. IPv6 addresses are normally enclosed between '[' and ']'.

This value of this property can be null (Nothing in Visual Basic).

The value of this property cannot be null (Nothing in Visual Basic).

The default value of this property is "" (String.Empty).

Exceptions
ExceptionDescription

A null reference (Nothing in Visual Basic) is passed to a method that does not accept it as a valid argument.

This is a usage error, i.e. it will never occur (the exception will not be thrown) in a correctly written program. Your code should not catch this exception.

Remarks

Machine resources are named using the naming scheme of the network transport. By default, all UNC ("\\server" or "server") and DNS names ("domain.com", "example.microsoft.com", or "135.5.33.19") names are allowed.

There are maximum length limitations on the machine name.

This member or type is for use from COM. It is not meant to be used from .NET or Python. Refer to the corresponding .NET member or type instead, if you are developing in .NET or Python.

Requirements

Target Platforms: .NET Framework: Windows 10 (selected versions), Windows 11 (selected versions), Windows Server 2016, Windows Server 2022; .NET: Linux, macOS, Microsoft Windows

See Also