OPC Studio User's Guide and Reference
ObjectDescriptor Constructor(String,String)



OpcLabs.BaseLib Assembly > OpcLabs.BaseLib Namespace > ObjectDescriptor Class > ObjectDescriptor Constructor : ObjectDescriptor Constructor(String,String)
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.

The value represents a UNC or DNS computer name. Any string can be passed to this parameter (i.e. will not cause System.ArgumentException), but not all values make sense and will work when an operation using them is attempted. IPv6 addresses are normally enclosed between '[' and ']'.

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

Contains the object ID. The object ID is either the object ProgID, or its {CLSID}, or ProgID/{CLSID}.

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

Initializes a new instance of the class, with specified machine name and object ID.
Syntax
'Declaration
 
Public Function New( _
   ByVal machineName As String, _
   ByVal objectId As String _
)
'Usage
 
Dim machineName As String
Dim objectId As String
 
Dim instance As New ObjectDescriptor(machineName, objectId)
public ObjectDescriptor( 
   string machineName,
   string objectId
)
public:
ObjectDescriptor( 
   String^ machineName,
   String^ objectId
)

Parameters

machineName
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.

The value represents a UNC or DNS computer name. Any string can be passed to this parameter (i.e. will not cause System.ArgumentException), but not all values make sense and will work when an operation using them is attempted. IPv6 addresses are normally enclosed between '[' and ']'.

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

objectId
Contains the object ID. The object ID is either the object ProgID, or its {CLSID}, or ProgID/{CLSID}.

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

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.

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