L_DicomGetFlags

#include "ltdic.h"

L_LTDIC_API L_UINT32 L_DicomGetFlags(hNet)

Returns currently set flags on the HDICOMNET.

Parameters

HDICOMNET hNet

A DICOM Network handle. This is the handle created by calling L_DicomCreateNet.

Returns

Currently set flags on the HDICOMNET.

Value Meaning
DICOMNET_FLAGS_NONE [0] No flags have been set.
DICOMNET_FLAGS_SENDDATA_WITH_GROUP_LENGTH_STANDARD_DATA_ELEMENTS [1] If set, group length elements will be sent for standard data element.

Comments

Group Length (gggg,0000) Standard Data Elements have been retired.
The default behavior is to not include Group Length Standard Data Elements in DICOM communication.

Setting the DICOMNET_FLAGS_SENDDATA_WITH_GROUP_LENGTH_STANDARD_DATA_ELEMENTS flag will include Group Length Standard Data Elements in DICOM communication.

Note that Elements in groups 0, 2, 4 and 6 are not Standard Data Element, so for these groups, this does not apply.

For example, the CommandGroupLength element (0000,0000) is still required for these DIMSE commands:

Required DLLs and Libraries

Platforms

Win32, x64, Linux.

See Also

Functions

Topics

Example

This example creates a DICOM network class, and sets a flag so that group lengths are included with standard data elements

L_INT ApiDicomNetGetFlagsTest(L_VOID) 
{ 
   // start the network  
   L_INT nRet = L_DicomStartUp(); 
   if (nRet != DICOM_SUCCESS) 
      return nRet; 
 
   // set the temporary file path 
   HDICOMNET hNet = L_DicomCreateNet(NULL, DICOM_SECURE_NONE); 
 
   assert(nRet == DICOM_SUCCESS); 
 
   // Set the flag to send group lengths with standard data elements 
   L_DicomSetFlags(hNet, DICOMNET_FLAGS_SENDDATA_WITH_GROUP_LENGTH_STANDARD_DATA_ELEMENTS); 
 
   // Verify that the flag was set to send group lengths with standard data elements 
   L_UINT32 uFlags = L_DicomGetFlags(hNet); 
   UNREFERENCED_PARAMETER(uFlags); 
   assert((uFlags & DICOMNET_FLAGS_SENDDATA_WITH_GROUP_LENGTH_STANDARD_DATA_ELEMENTS) == DICOMNET_FLAGS_SENDDATA_WITH_GROUP_LENGTH_STANDARD_DATA_ELEMENTS); 
 
   // do some network communication here 
   // ...  
 
   // free the DICOM net object 
 
   L_DicomFreeNet(hNet); 
 
   // shut down the network 
   L_DicomShutDown(); 
   return DICOM_SUCCESS; 
} 

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

LEADTOOLS DICOM C API Help