SetRoleSelect Method

Summary

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

C++

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

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

public: 
void SetRoleSelect(  
   byte id, 
   bool enabled, 
   DicomRoleSupport user, 
   DicomRoleSupport 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