DicomDataSetCollection RetrieveMetaData( 
   string StudyUID,
   string SeriesUID,
   string InstanceUID
)

DicomDataSetCollection^ RetrieveMetaData( 
   String^ StudyUID,
   String^ SeriesUID,
   String^ InstanceUID
) 

'Declaration
 
Function RetrieveMetaData( _
   ByVal StudyUID As String, _
   Optional ByVal SeriesUID As String, _
   Optional ByVal InstanceUID As String _
) As DicomDataSetCollection

'Usage
 
Dim instance As IWadoWebClient
Dim StudyUID As String
Dim SeriesUID As String
Dim InstanceUID As String
Dim value As DicomDataSetCollection
 
value = instance.RetrieveMetaData(StudyUID, SeriesUID, InstanceUID)

Parameters

StudyUID

The Requested StudyUID

SeriesUID

The Requested series UID (may be null/absent)

InstanceUID

The Requested instance UID (may be null/absent)

Return Value

This is intended to get a "quick overview" of instances before getting them fully, but if the instances are "used" (e.g. by viewing or writing out), then DicomObjects will automatically retrieve any "missing" data as required via individual bulk data retrieval calls. WHilst efficient for one or two elements (perhaps one frame of an image), if the whole instance is needed, then it is more efficient either to retrieve in native form, or to add all the bulk data items in one go via WadoWebClient.AppendBulkData .

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

IWadoWebClient Interface
IWadoWebClient Members