| LEADTOOLS DICOM C DLL Help > Function References > L_DicomGetCalled | 
#include "ltdic.h"
L_LTDIC_API L_VOID L_DicomGetCalled(hPDU, strCalled, SizeInWords)
| HDICOMPDU hPDU; | /* a DICOM Associate handle */ | 
| L_TCHAR *strCalled; | /* buffer to be updated */ | 
| L_UINT32 SizeInWords; | /* size of the destination string buffer */ | 
Returns the name of the Application Entity that was called.
| Parameter | Description | 
| hPDU | A DICOM Associate handle. | 
| strCalled | String Buffer to be updated with the name of the Application Entity that was called. | 
| SizeInWords | size of the destination string buffer. | 
Returns
None.
Comments
For more information on the structure of an Associate, refer to LEADTOOLS DICOM Network Communication Support for Message Exchange.
Required DLLs and Libraries
| 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, Linux.
See Also
| Functions: | |
| Topics: | 
Example
L_INT DicomGetCalledExample(HDICOMPDU hPDU)
{
   L_INT nRet;
   L_TCHAR szCalled[PDU_MAX_TITLE_SIZE+1];
   L_TCHAR szCalling[PDU_MAX_TITLE_SIZE+1];
   /* set called application title */
   nRet = L_DicomSetCalled(hPDU, TEXT("Called Program"));
   if (nRet != DICOM_SUCCESS)
      return nRet;
   /* set calling application title */
   nRet = L_DicomSetCalling(hPDU, TEXT("Calling Program"));
   if (nRet != DICOM_SUCCESS)
      return nRet;
   /* display the current values */
   L_DicomGetCalled(hPDU, szCalled, PDU_MAX_TITLE_SIZE+1);
   L_DicomGetCalling(hPDU, szCalling, PDU_MAX_TITLE_SIZE+1);
   MessageBox(NULL, szCalled, TEXT("Test"), MB_OK);
   MessageBox(NULL, szCalling, TEXT("Test"), MB_OK);
   return DICOM_SUCCESS;
}