- 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.
Visual Basic (Declaration) | |
---|---|
Public Sub SetRoleSelect( _ ByVal id As Byte, _ ByVal enabled As Boolean, _ ByVal user As DicomRoleSupport, _ ByVal provider As DicomRoleSupport _ ) |
Visual Basic (Usage) | Copy Code |
---|---|
|
C# | |
---|---|
public void SetRoleSelect( byte id, bool enabled, DicomRoleSupport user, DicomRoleSupport provider ) |
C++/CLI | |
---|---|
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.
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 DicomAssociate.IsRoleSelect.
Target Platforms: Microsoft .NET Framework 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family