SetRoleSelect Method

Enables or disables Role Selection. It also sets the User Role and Provider Role, if enabled, for the specified Presentation Context of the DICOM Associate.

Syntax

public void SetRoleSelect( 
   byte id,
   bool enabled,
   DicomRoleSupport user,
   DicomRoleSupport provider
)

public void SetRoleSelect( 
   byte id,
   bool enabled,
   DicomRoleSupport user,
   DicomRoleSupport provider
)

 function Leadtools.Dicom.DicomAssociate.SetRoleSelect( 
   id ,
   enabled ,
   user ,
   provider 
)

public:
void SetRoleSelect( 
   byte id,
   bool enabled,
   DicomRoleSupport user,
   DicomRoleSupport provider
)

'Declaration
 
Public Sub SetRoleSelect( _
   ByVal id As Byte, _
   ByVal enabled As Boolean, _
   ByVal user As DicomRoleSupport, _
   ByVal provider As DicomRoleSupport _
)

'Usage
 
Dim instance As DicomAssociate
Dim id As Byte
Dim enabled As Boolean
Dim user As DicomRoleSupport
Dim provider As DicomRoleSupport
 
instance.SetRoleSelect(id, enabled, user, provider)

Parameters

id: Presentation Context ID of the Presentation Context for which to set the User Role and Provider Role. The ID provides information about both the class type of the data and the Transfer Syntax to use when transferring the data. It also identifies a specific Presentation Context within an Associate.
enabled: true to enable Role Selection; otherwise, false.
user: Indicates whether or not to support the User Role for the specified Presentation Context.
provider: Indicates whether or not to support the Provider Role for the specified Presentation Context.

Remarks

If Role Selection is enabled for a specific Presentation Context, that Application Entity can act as an SCU, an SCP or both for that Presentation Context.

For example, suppose a DICOM Associate Request has three Presentation Contexts. One Presentation Context is for the transfer of X-RAY data, another Presentation Context is for the transfer of CT data, and the third Presentation Context is for the transfer of Nuclear Medicine data.

To serve only as an SCU for the X-RAY data transfer, the User Role for the first Presentation Context should be DicomRoleSupport.Supported, while the Provider Role should be DicomRoleSupport.Unsupported.

To serve as both an SCU and an SCP for the CT data transfer, the User Role and the Provider Role should both be DicomRoleSupport.Supported for the second Presentation Context.

To serve only as an SCU for the Nuclear Medicine data transfer, the User Role for the third Presentation Context should be DicomRoleSupport.Supported, while the Provider Role should be DicomRoleSupport.Unsupported.

If Role Selection is enabled, the User Role and Provider Role settings can be retrieved using GetUserRole and GetProviderRole.

To determine whether Role Selection is enabled, use IsRoleSelect.

Example

For an example, refer to IsRoleSelect.

Requirements

Target Platforms

Reference

DicomAssociate Class
DicomAssociate Members
IsRoleSelect Method
GetUserRole Method
GetProviderRole Method