White Papers

52 Version 1.0.0a
5) When the CreateDevices Boolean parameter is TRUE, in addition to the USB device references
in the USBDevices parameter, the CreateRedirectionSAP() method will create new instances of
CIM_USBDevices as specified in the NewUSBDevices parameter and associate them with the
new SAP. Each instance of the concrete subclass of CIM_LogicalDevice specified in the
RedirectedLogicalDevices[] parameter that is not NULL will be associated with the new instance
of CIM_USBDevices that was specified in the same entry in the NewUSBDevices parameter by
a CIM_LogicalIdentity association.
The client starts Virtual Media on the remote node; the remote node will attempt to establish a
session with the protocol endpoint of the managed node.
9.21 Deleting a USB Redirection SAP and associated USB devices
A client can delete a USB Redirection SAP and the instances of CIM_USBDevice that have been created
as follows:
1) Start at the DCIM_OEMVirtualMediaService instance of interest.
2) Inspect the SAPCapabilitiesSupported for the value 2 (Create SAPs) to confirm that creating a
new SAP is supported.
3) Invoke the DeleteRedirectionSAP() method specifying the SAP to be deleted in the SAP
parameter, and specifying TRUE for the DeleteUSBDevices parameter. If the SAP was not pre-
configured, it will be deleted. The instances of CIM_USBDevice that are associated with the
SAP that were not pre-configured will be deleted. The associations referencing the deleted
SAP and deleted USB devices will also be deleted. Pre-configured SAPs and USB devices will
not be deleted.
9.22 Deleting a USB Redirection SAP and associated USB devices
A client can delete a USB Redirection SAP that has been created without deleting the instances created
by CIM_USBDevice as follows:
1) Start at the DCIM_OEMVirtualMediaService instance of interest.
2) Inspect the SAPCapabilitiesSupported for the value 2 (Create SAPs) to confirm that creating a
new SAP is supported.
3) Invoke the DeleteRedirectionSAP() method specifying the SAP to be deleted in the SAP
parameter. If the SAP was not pre-configured, it will be deleted. The associations referencing
the deleted SAP will also be deleted. Pre-configured SAPs will not be deleted. Instances of
CIM_USBDevice that have been created by CreateUSBDevice or CreateRedirectionSAP may
be deleted later using the CIM_USBDevice class “Delete” intrinsic, which will delete the
previously created instances of CIM_USBDevice and all the associations that reference the
instance being deleted. Pre-configured instances of CIM_USBDevice may not be deleted by
the class Delete intrinsic.
9.23 Determine Whether DCIM_OEMVirtualMediaService.ElementName Can Be
Modified
A client can determine whether the ElementName property can be modified as follows:
1) Start at the instance of DCIM_OEMVirtualMediaService.
2) Find the CIM_USBRedirectionCapabilities instance that it is associated with by the
CIM_ElementCapabilities association.
3) Query the value of the ElementNameEditSupported property of the
CIM_USBRedirectionCapabilities instance.