LFile::GetFileName

#include "ltwrappr.h"

L_TCHAR * LFile::GetFileName()

L_INT LFile::GetFileName(pBuffer, puBuffSize)

L_TCHAR * pBuffer;

/* character string to be updated */

L_UINT * puBuffSize;

/* size of pBuffer */

LFile::GetFileName() gets a pointer to the internal file name.

LFile::GetFileName(pBuffer, puBuffSize) gets a copy of the internal file name.

Parameter

Description

pBuffer

Character string that will be updated with the internal file name.

uBuffSize

Pointer to a variable to be updated with the size of pBuffer.

Returns

LFile::GetFileName returns a pointer to the internal file name. You should not attempt to free this pointer.

LFile::GetFileName(pBuffer, uBuffSize) returns the following:

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Required DLLs and Libraries

LTFIL
File format DLLs

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:

Class Members

Example

L_INT LFile__GetFileNameExample(HWND hWnd)
{
   LFile              LeadFile ;
   LBitmapBase LeadBitmap ;
   L_INT             nRet = 0;
   L_TCHAR        *szOldFileName = NULL;
   L_TCHAR        *szNewFileName = NULL;
   
   LeadFile.SetBitmap(&LeadBitmap) ;
   LeadFile.SetFileName(TEXT("%UserProfile%\\My Documents\\LEADTOOLS Images\\image1.cmp")) ;
   MessageBox(0,LeadFile.GetFileName() ,TEXT("file to load"),MB_OK);
   nRet = LeadFile.LoadFile (24, ORDER_RGB, LOADFILE_ALLOCATE | LOADFILE_STORE) ;
   if(nRet != SUCCESS)
      return nRet;
   LeadFile.SetFileName (TEXT("%UserProfile%\\My Documents\\LEADTOOLS Images\\TESTSTMP.CMP"));
   // Save a CMP file
   nRet = LeadFile.Save(FILE_CMP);
   if (nRet == SUCCESS)
   {
      L_TCHAR   szBuffer[256] ;
      L_UINT   puFileNameLen ;
      MessageBox (hWnd, TEXT("Function complete - Look at TESTSTMP.CMP"), TEXT("Notice"), MB_OK);
      LeadFile.GetFileName(szNewFileName,&puFileNameLen) ;
      wsprintf(szBuffer,TEXT("Old File Name = %s\nBitmap compressed with stamp to\nNew File Name = %s\n"), szOldFileName,szNewFileName) ;
      MessageBox(hWnd,szBuffer,TEXT("Information"),MB_OK);
   }
   else
      return nRet;
   nRet = LeadBitmap.Free() ;
   if(nRet != SUCCESS)
      return nRet;
   return SUCCESS;
}