LEADTOOLS DICOM C DLL Help > Function References > L_DicomAddPresentation |
#include "ltdic.h"
L_LTDIC_API L_INT L_DicomAddPresentation(hPDU, nID, nResult, pszAbstract)
HDICOMPDU hPDU; |
/* a DICOM Associate handle */ |
L_UCHAR nID; |
/* presentation ID */ |
L_UCHAR nResult; |
/* result */ |
L_TCHAR * pszAbstract; |
/* abstract */ |
Adds a Presentation Context to the specified DICOM Associate.
Parameter |
Description |
|
hPDU |
A DICOM Associate handle. |
|
nID |
Presentation ID. The presentation ID provides information about both the class type of the data and the transfer syntax to use when transferring the data. The ID should be unique. It should start at 1 and it must be odd. (1, 3, 5, ) |
|
nResult |
The result value. This is only valid for Associate Accept. It will be ignored in an Associate Request. Possible values are: |
|
|
Value |
Meaning |
|
PDU_ACCEPT_RESULT_SUCCESS |
[0] Success |
|
PDU_ACCEPT_RESULT_USER_REJECT |
[1] User rejection |
|
PDU_ACCEPT_RESULT_PROVIDER_REJECT |
[2] No reason (provider rejection) |
|
PDU_ACCEPT_RESULT_ABSTRACT_SYNTAX |
[3] Abstract Syntax not supported. (provider rejection) |
|
PDU_ACCEPT_RESULT_TRANSFER_SYNTAX |
[4] Transfer Syntax not supported. (provider rejection) |
pszAbstract |
Abstract Syntax. This indicates the class type of the data. For a list of possible values, refer to Abstract Syntax Values. |
Returns
DICOM_SUCCESS |
The function was successful. |
>0 |
An error occurred. Refer to Return Codes. |
Comments
A DICOM Associate (Request or Accept) can have multiple Presentation Contexts. A Presentation Context can be added by specifying a unique ID for the new Presentation Context and valid values for the Result (Associate Accept Presentation Context entries only) and the Abstract Syntax.
Required DLLs and Libraries
For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application |
Win32, x64, Linux.
See Also
Functions: |
L_DicomGetPresentation, L_DicomSetPresentation, L_DicomGetPresentationCount, L_DicomDelPresentation |
Topics: |
Example
For an example, refer to L_DicomDelPresentation.