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

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

Platforms

Win32, x64

See Also

Functions:

L_DicomGetPresentation, L_DicomSetPresentation, L_DicomGetPresentationCount, L_DicomDelPresentation

Topics:

Working with DICOM Associate Connections

Example

For an example, refer to L_DicomDelPresentation.