L_DicomAddUserInfo

#include "ltdic.h"

L_LTDIC_API L_INT L_DicomAddUserInfo(hPDU, nType, pData, nLength)

HDICOMPDU hPDU;

/* a DICOM Associate handle */

L_UCHAR nType;

/* type */

L_UCHAR * pData;

/* user data */

L_UINT16 nLength;

/* length */

Appends a User-defined item to the specified DICOM Associate.

Parameter

Description

hPDU

A DICOM Associate handle.

nType

Type of the User-defined item.

pData

Buffer that contains the data for the User-defined item.

nLength

Length of the User-defined item.

Returns

0

SUCCESS

>0

An error occurred. Refer to Return Codes.

Comments

User-defined items may be included in the DICOM Associate to provide any other data the user finds necessary when establishing a DICOM Associate connection. The basic structure of the User-defined item is

image\UserData.gif

where the Type, Length and User Data are all determined by the user. The values shown are the lengths, in bytes, of the elements of the User-defined item.

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_DicomGetUserInfoCount, L_DicomGetLengthUserInfo, L_DicomGetDataUserInfo, L_DicomGetTypeUserInfo, L_DicomSetUserInfo, L_DicomDelUserInfo

Topics:

Working with DICOM Associate Connections

Example

For an example, refer to L_DicomGetUserInfoCount.