CONNECTCALLBACK

#include "ltdic.h"

L_VOID pEXT_CALLBACK Your Function(hNet, nError, UserData)

HDICOMNET hNet;

/* a DICOM Network handle */

L_INT nError;

/* error code */

L_VOID * UserData;

/* pointer to additional data */

Notifies the SCU that the connection attempt is complete. This function is available in the Medical Suite Toolkit.

Parameter

Description

hNet

A DICOM Network handle.

nError

Error code. Refer to Return Codes.

UserData

Void pointer that you can use to access a variable or structure containing data that your callback function needs. This gives you a way to receive data indirectly from the function that uses this callback function.

 

Keep in mind that this is a void pointer, which must be cast to the appropriate data type within your callback function.

Returns

None.

Comments

A call to this function is generated on an SCU when an SCP calls L_DicomAccept. It is generated whether or not the connection attempt is successful. It is also generated when a connection attempt has timed out.

To use this callback function, CONNECTCALLBACK must be set using L_DicomSetCallback.

A DICOM Association must be established between an SCU and an SCP before any DICOM messages or data can be transmitted between them. For more information on creating a DICOM Association, refer to Creating a DICOM Associate Connection.

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_DicomConnect, L_DicomAccept, ACCEPTCALLBACK

Topics:

Creating a DICOM Network Connection

Example

For an example, refer to L_DicomConnect.