L_DicomGetFlags

Summary

Returns currently set flags on the HDICOMNET.

Syntax

L_LTDIC_API L_UINT32 L_DicomGetFlags(hNet)

Parameters

HDICOMNET hNet

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

Returns

Currently set flags on the HDICOMNET.

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:

• C-STORE-RQ
• C-STORE-RSP
• C-FIND-RQ
• C-FIND-RSP
• C-CANCEL-FIND-RQ
• C-GET-RQ
• C-GET-RSP
• C-CANCEL-GET-RQ
• C-MOVE-RQ
• C-MOVE-RSP
• C-CANCEL-MOVE-RQ
• C-ECHO-RQ
• C-ECHO-RSP
• N-EVENT-REPORT-RQ
• N-EVENT-REPORT-RSP
• N-GET-RQ
• N-GET-RSP
• N-SET-RQ
• N-SET-RSP
• N-ACTION-RQ
• N-ACTION-RSP
• N-CREATE-RQ
• N-CREATE-RSP
• N-DELETE-RQ
• N-DELETE-RSP

Required DLLs and Libraries

• LTKRN
• For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

Platforms

Win32, x64, Linux.

See Also

Functions

• L_DicomSetFlags

Topics

• Working with DICOM Network Connections

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; 
}