LEADTOOLS DICOM C++ Class Library Help > Classes and Member Functions > LDicomContextGroup > LDicomContextGroup Class Members > LDicomContextGroup::Load |
#include "ltdic.h"
static L_UINT16 LDicomContextGroup::Load(pszContextID = NULL)
L_TCHAR * pszContextID; |
/* Context ID */ |
Loads the specified Context Group from the internal table into the Context Group Table.
Parameter |
Description |
pszContextID |
Character string that contains the Context Identifier (CID) of the Context Group to be loaded from the internal table. For a list of possible values, refer to Context Identifier Values. If this parameter is set to NULL, the function loads all the Context Groups that are currently unloaded. |
Returns
0 |
The function was successful. |
>0 |
An error occurred. Refer to Return Codes. |
Comments
You can add a Context Group to the Context Group Table either by loading it from the internal table maintained by LEADTOOLS or by inserting it directly into the Context Group Table. The Context Groups in the internal table are those defined by the DICOM Content Mapping Resource (DCMR). For a list of possible values, refer to Context Identifier Values. Use the Load function to load the desired Context Groups from this table into the Context Group Table. To insert a Context Group, use the LDicomContextGroup::Insert function.
If the Context Group Table already contains a Context Group with the specified Context ID, the function will just return successfully. If the parameter pszContextID is set to NULL, the function will load all the Context Groups that are not loaded currently, without affecting any Context Group that is already in the Context Group Table. (Therefore, to load all of the Context Groups in the internal table from the beginning, call the function with the pszContextID parameter set to NULL.)
A return value of DICOM_ERROR_PARAMETER indicates that the internal table doesn't contain a Context Group with the specified Context ID.
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 |
Win32, x64
See Also
Example
For an example, refer to LDicomContextGroup::GetFirst.