SetRoleSelect method (ILEADDicomNet)

VB.NET example	C# example
Visual Basic example	Visual C++ 6.0 example

Syntax	short SetRoleSelect (long hPDU, short nID, BOOL bEnabled, short nUser, short nProvider);
Overview	Refer to Working with DICOM Associate Connections.

Remarks

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

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 as an SCU only for the X-RAY data transfer, the User Role for the first Presentation Context should be PDU_ROLE_SUPPORT, while the Provider Role should be PDU_ROLE_NON_SUPPORT.

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

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

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

To determine whether Role Selection is enabled, use the IsRoleSelect method.

Elements:	IsRoleSelect method, GetUserRole method, GetProviderRole method
Topics:	DICOM Associate Connection: Modifying a DICOM Associate Handle