LDicomNet::SendCEchoRequest
#include "ltdic.h"
L_INT LDicomNet::SendCEchoRequest(nPresentationID, nMessageID, pszClass)
L_UCHAR nPresentationID; |
/* presentation ID */ |
L_UINT16 nMessageID; |
/* message ID */ |
L_TCHAR * pszClass; |
/* class type */ |
Sends a C-ECHO-REQ message to a peer member of a connection. This function is available in the Medical Suite Toolkit.
Parameter |
Description |
nPresentationID |
Presentation ID. The presentation ID provides information about both the class type of the data and the transfer syntax to use when transferring the data. |
nMessageID |
Message ID. Each message sent by a member of a connection should have a unique ID. Since a member of a connection may send several messages, this ID allows that member to identify when a specific request has been completed. |
pszClass |
Class affected by the request. This will be an SOP Class or an SOP MetaClass. |
Returns
0 |
SUCCESS |
>0 |
An error occurred. Refer to Return Codes. |
Comments
Calling this function generates a call to LDicomNet::OnReceiveCEchoRequest on the SCP. The SCP should respond by calling LDicomNet::SendCEchoResponse which will generate a call to LDicomNet::OnReceiveCEchoResponse.
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 |
See Also
Functions: |
LDicomNet::SendCEchoResponse, LDicomNet::OnReceiveCEchoRequest, LDicomNet::OnReceiveCEchoResponse |
Topics: |
Example
L_INT LDicomNet__SendCEchoRequestExample(LMyDicomNet *m_pDicomNet) { //This example sends an Echo Request Command to the server //In this example: // //1. LMyDicomNet is a class derived from LDicomNet //2. LMyDicomNet has the following member variables: // m_nClientOrServer: can be (STATUS_NONE, STATUS_SERVER, STATUS_CLIENT) // identifieds the LMyDicomNet object as a server or a client // m_nDataCommand: can be (COMMAND_C_MOVE,COMMAND_C_GET) // set so the server knows how a C-Store Response was generated // //3. m_pDicomNet points to a valid LMyDicomNet object // LMyDicomNet *m_pDicomNet // //4. A connection exists between client and server //5. An association exists between the client and server L_INT nRet; CString strMsg= TEXT("C-Echo\n"); //Is class supported in the assocation? L_UCHAR nPresentationID = m_pDicomNet->GetAssociate()->FindAbstract(UID_VERIFICATION_CLASS); //nPresentationID must be odd--if 0, indicates failure if (nPresentationID==0) { CString strTmp; strTmp.Format(TEXT("Abstract Syntax[%s] Not Included in the Association"), UID_VERIFICATION_CLASS); strMsg = strMsg + strTmp; } else //success { L_UINT16 uUniqueID = 99; nRet =m_pDicomNet->SendCEchoRequest(nPresentationID, uUniqueID, UID_VERIFICATION_CLASS); if(nRet > 0) return nRet; } AfxMessageBox(strMsg); return DICOM_SUCCESS; }