Welcome to the Harris Geospatial product documentation center. Here you will find reference guides, help documents, and product libraries.


Harris Geospatial / Docs Center / IDL Reference / DICOM Toolkit / IDLffDicomExQuery::Read

IDLffDicomExQuery::Read

IDLffDicomExQuery::Read

The IDLffDicomExQuery::Read function method reads content that has been received from a DICOM server.

Example


For an example of setting up the configuration and query properties, see IDLffDicomExQuery::Query.

oQuery = IDLffDicomExQuery()
oQuery.SetProperty, QUERY_SCP = 'remote_qr_scp_aen'
reqID = oQuery.OpenFindRQ('STUDY_ROOT_QR_FIND')
oQuery.SetValue, reqID, '0008,0052', 'SERIES'
assocID = oQuery.Send(reqID, STATUS=status)
reqID = oQuery.Read(assocID, STATUS=status)
value = oQuery.GetValue(reqID, '0020,1206')
oQuery.Close, assocID
oQuery.FreeMessage, reqID

Syntax


Result = Obj.[IDLffDicomExQuery::]Read( AssociationID [, COMMAND=variable] [, SERVICENAME=variable] [, STATUS=variable] [, TIMEOUT=value] )

Return Value


This method returns a scalar integer giving the message ID for the content received from the server, or !NULL if no content is available in the specified timeout.

Arguments


AssociationID

Set this argument to an integer giving the association ID from a previous call to IDLffDicomExQuery::Send.

Keywords


COMMAND

Set this keyword to a named variable to return the command associated with the message.

SERVICENAME

Set this keyword to a named variable to return the service name associated with the message.

STATUS

Set this keyword to a named variable in which the status code for the operation will be returned. If STATUS is not specified then any error messages will be output to the screen and IDL will halt execution.

Tip: The status code can be converted to a human-readable string using the IDLffDicomExQuery::MC_Status method.

TIMEOUT

Set this to the maximum number of milliseconds to wait for incoming content from the server. The default is 3000 (3 seconds).

Version History


8.6.1

Introduced

See Also


IDLffDicomExQuery::MC_Status, IDLffDicomExQuery::GetValue, IDLffDicomExQuery::Send



© 2017 Exelis Visual Information Solutions, Inc. |  Legal
My Account    |    Buy    |    Contact Us