在本主题▼

L_DicomGetStringValue

# include“Ltdic.h”

L_LTDIC_APIL_TCHAR* L_DicomGetStringValue(hDS, pElement, nIndex, nCount)

返回一个指针，指向存储在指定元素的value Field中的字符串值。

参数

HDICOMDShDS

一个DICOM句柄。

pDICOMELEMENTpElement

指向DICOMELEMENT数据集中的结构。

L_UINT32nIndex

指示在值字段中存储多个值时检索哪个值的索引值。索引从零开始。

L_UINT32nCount

值，该值指示在值字段中存储多个值时要检索的值的数量。在大多数情况下，您将只检索一个值，因此此参数将为1。

价值	意义
零!	指向存储在指定数据元素的值字段中的字符串值的指针。
零	Value Field的长度为0，函数是为不正确的VR类型调用的，或者函数是为文件夹(序列)元素调用的。

如果在指定数据元素的value Field中存储了多个值，则可以检索其中一个或多个元素。例如，如果指定数据元素的Value Field包含三个字符串值，并且您只对检索最后两个字符串值感兴趣，则将nIndex设置为1,nCount设置为2。这告诉函数检索从位置1开始的字符串值(索引以0为基础)并检索两个值。因此，您将检索Value Field中位置1和2的值。

只有当数据元素的值表示形式为VR_AE、VR_CS、VR_LO、VR_LT、VR_SH、VR_ST、VR_UI、VR_UT、VR_PN时，才能调用该函数。有关值表示的详细信息，请参见默认值表示表．

当检索到多个字符串时，由0分隔符分隔的所有字符串都在此函数返回的字符串中。例如，下图显示了返回的字符串，包含三个由0分隔符分隔的字符串。

$图像\ String.gif$