In This Topic ▼

LFile::GetFileName

Summary

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

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

Syntax

#include "ltwrappr.h"

L_TCHAR * LFile::GetFileName()

L_INT LFile::GetFileName(pBuffer, puBuffSize)

Parameters

L_TCHAR * pBuffer

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

L_UINT * puBuffSize

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:

Value	Meaning
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.

Platforms

Win32, x64.

Example

L_INT LFile__GetFileNameExample(HWND hWnd) 
{ 
   L_INT         nRet = 0; 
   CString       szMessage; 
   L_UINT        puFileNameLen ; 
   L_TCHAR       szOldFileName[255] ; 
   L_TCHAR       szNewFileName[255] ; 
   LFile         LeadFile; 
   LBitmapBase   LeadBitmap; 
 
   LeadFile.SetBitmap(&LeadBitmap) ; 
   LeadFile.SetFileName(MAKE_IMAGE_PATH(TEXT("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; 
 
   nRet = LeadFile.GetFileName(szOldFileName,&puFileNameLen) ; 
   if(nRet < 1) 
      return nRet; 
 
   LeadFile.SetFileName (MAKE_IMAGE_PATH(TEXT("TESTSTMP.CMP"))); 
 
   // Save a CMP file 
   nRet = LeadFile.Save(FILE_CMP); 
   if (nRet == SUCCESS) 
   { 
      MessageBox (hWnd, TEXT("Function complete - Look at TESTSTMP.CMP"), TEXT("Notice"), MB_OK); 
      nRet = LeadFile.GetFileName(szNewFileName,&puFileNameLen); 
      if(nRet < 1) 
         return nRet; 
 
      szMessage.Format(L"Old File Name = %s\nBitmap compressed with stamp to\nNew File Name = %s", szOldFileName, szNewFileName); 
      MessageBox(hWnd,szMessage,TEXT("Information"),MB_OK); 
   } 
   else 
      return nRet; 
 
   nRet = LeadBitmap.Free() ; 
   if(nRet != SUCCESS) 
      return nRet; 
 
   return SUCCESS; 
}