S25 Updating a Device

This article describes how to update an existing device in the project tree, using a different device description.

The code snippet below replaces an existing device by a different one. The parameters for this utility method are as follows: 

  • nProjectHandle and objectGuid specify device to be replaced.
  • nDeviceType, stDeviceId, stModuleId, and stVersion describe which device type should be created. stModuleId is optional and might be null. Please refer to the device description for detailed information about the device identification. Example: The current identification of a PLCWinNT device is nDeviceType=4096, stDeviceId="0000 0001", stModuleId=null, stVersion="3.4.0.0".
public static void UpdateDeviceObject(
 int projectHandle,
 Guid objectGuid,
 int deviceType,
 string deviceId,
 string moduleId,
 string version)
{
 if (deviceId == null)
 throw new ArgumentNullException("deviceId");
 if (version == null)
 throw new ArgumentNullException("version");

 string[] batchArguments;
 if (moduleId != null)
 {
 batchArguments = new string[6];
 batchArguments[0] = projectHandle.ToString();
 batchArguments[1] = deviceType.ToString();
 batchArguments[2] = deviceId;
 batchArguments[3] = version;
 batchArguments[4] = "-M=" + moduleId;
 batchArguments[5] = objectGuid.ToString();
 }
 else
 {
 batchArguments = new string[5];
 batchArguments[0] = projectHandle.ToString();
 batchArguments[1] = deviceType.ToString();
 batchArguments[2] = deviceId;
 batchArguments[3] = version;
 batchArguments[4] = objectGuid.ToString();
 }

 if (SystemInstances.Engine.CommandManager is ICommandManager2)
 ((ICommandManager2)SystemInstances.Engine.CommandManager).ExecuteCommand(GUID_REPLACEDEVICECOMMAND, batchArguments);
}

private static readonly Guid GUID_REPLACEDEVICECOMMAND = new Guid("{361c88a2-559e-4893-9fc5-c2fc635dcbc4}");