L_DicomGetUserRole

#include "ltdic.h"

L_LTDIC_API L_UCHAR L_DicomGetUserRole(hPDU, nID)

HDICOMPDU hPDU;

/* a DICOM Associate handle */

L_UCHAR nID;

/* presentation ID */

Returns the value for the User Role of the specified Presentation Context of the specified DICOM Associate.

Parameter

Description

hPDU

A DICOM Associate handle.

nID

Presentation ID of the Presentation Context from which to retrieve the User Role. The presentation 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.

Returns

The value for the User Role of the specified Presentation Context of the specified DICOM Associate. Possible values are:

Value

Meaning

PDU_ROLE_NON_SUPPORT

[0] User role not supported.

PDU_ROLE_SUPPORT

[1] User role supported.

Comments

Support for the User Role allows the Application Entity to act as an SCU for that Presentation Context.

To enable Role Selection, call L_DicomSetRoleSelect.

To set the User and Provider Roles, call L_DicomSetRoleSelect.

Required DLLs and Libraries

LTDIC

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

See Also

Functions:

L_DicomIsRoleSelect, L_DicomGetProviderRole, L_DicomSetRoleSelect

Topics:

Working with DICOM Associate Connections

Example

For an example, refer to L_DicomIsRoleSelect.