RECEIVEUNKNOWNCALLBACK

Summary

Notifies a connection that an unknown command was received. This function is available in the PACS Imaging.

Syntax

#include "ltdic.h"

L_VOID pEXT_CALLBACK Your Function(hNet, nPresentationID, hCS, hDS, pUserData)

Parameters

HDICOMNET hNet

A DICOM Network handle to the peer member of the connection.

L_UCHAR nPresentationID

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.

HDICOMDS hCS

A DICOM handle that references the command set that contains the actual command message.

HDICOMDS hDS

A DICOM handle that contains the actual data. This may be NULL if no data set is included.

L_VOID * pUserData

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 when an unknown command is received.

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

Required DLLs and Libraries

Platforms

Win32, x64

See Also

Topics

Example

L_VOID EXT_CALLBACK OnReceiveUnknown(HDICOMNET hNet, L_UCHAR nPresentationID, HDICOMDS hCS, HDICOMDS hDS, L_VOID *pUserData) 
{ 
   UNREFERENCED_PARAMETER(hCS); 
   UNREFERENCED_PARAMETER(pUserData); 
   UNREFERENCED_PARAMETER(hDS); 
   UNREFERENCED_PARAMETER(hNet); 
 
   L_TCHAR szOut[800]; 
    
   wsprintf(szOut, TEXT("Unknown Command Set/Data Set was received, and ignored\nPresentation ID: %d"), nPresentationID); 
   MessageBox(NULL, szOut, TEXT("Unknown"), MB_OK); 
} 
Help Version 23.0.2024.7.1
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 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.