L_DicomSetPresentation

Summary

Sets the ID for a Presentation Context.

Syntax

#include "ltdic.h"

L_LTDIC_API L_INT L_DicomSetPresentation(hPDU, nIndex, nID)

Parameters

HDICOMPDU hPDU

A DICOM Associate handle.

L_INT nIndex

Index of the Presentation Context to set.

L_UCHAR 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. It must be unique. It should start at 1 and it must be odd. (1, 3, 5, )

Returns

Value Meaning
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. The ID for each of these Presentation Contexts must be unique. The IDs for the Presentation Context entries for the specified DICOM Associate should start at 1, and must be odd.

For example, a DICOM Associate may have three Presentation Context entries. One of those entries should have an ID of 1. The IDs must be unique. (Having two Presentation Context entries with an ID of 3 is not valid.) Therefore the IDs may be 1 for the first Presentation Context, 3 for the next one and 5 for the last one.

Required DLLs and Libraries

Platforms

Win32, x64, Linux.

See Also

Functions

Topics

Example

For an example, refer to L_DicomDelPresentation.

Help Version 22.0.2022.12.7
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C API Help

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.