2.1.10.20 GetFileModificationDate

1 Description
2 Syntax
3 Parameters
4 Return
5 Examples
6 Remark
7 See Also
8 Header to Include
9 Reference

Description

Get the file modification date of a file from an input string containing a path and filename.

Syntax

BOOL GetFileModificationDate( LPCSTR lpcstrPathAndFilename, SYSTEMTIME & pSysTime )

string GetFileModificationDate( LPCSTR lpcstrPathAndFilename, WORD wFormat = LDF_SHORT )

Parameters

lpcstrPathAndFilename: [input] string containing a path and filename with filetype extension
pSysTime: [output] pointer to a SYSTEMTIME structure that will receive the file's modification time

lpcstrPathAndFilename: [input] string containing a path and filename with filetype extension
wFormat: [input] a date format flag to determine the appearance of the formatted string.; These includes: LDF_SHORT, LDF_LONG, LDF_ALPHAMONTH_NUMERICDAY, LDF_NUMERICMONTH_NUMERICDAY,; LDF_NUMERICDAY, LDF_ALPHAWEEKDAY_3CHR, LDF_ALPHAWEEKDAY_1CHR, LDF_NUMERICYEAR_4DIGIT,; LDF_NUMERICYEAR_2DIGIT, LDF_SHORT_AND_HHMM_SEPARCOLON, LDF_SHORT_AND_HHMMSS_SEPARCOLON,; LDF_YYMMDD, LDF_YYMMDD_AND_HHMM_SEPARCOLON, LDF_YYMMDD_AND_HHMMSS_SEPARCOLON,; LDF_YYMMDD_AND_HHMM, LDF_YYMMDD_AND_HHMMSS, LDF_ALPHAMON_3CHR, LDF_ALPHAMON_1CHR,; LDF_QUARTER, LDF_CUSTOM1, LDF_CUSTOM2 .; See the definitions of LDF_* in OC_Const.h .

Return

Returns TRUE for success else FALSE for error

Returns a Windows like file modification date formatted for display.

Examples

EX1

void GetFileModificationDate_ex1()
{            
    string strTempFile;
    string strFileDate;
    WORD wFormat = LDF_YYMMDD;
    GetTempFileName(strTempFile,"ABC");
 
    SYSTEMTIME sysTime;
    if( GetFileModificationDate(strTempFile, sysTime) )
    {
        LPSTR lpstr = strFileDate.GetBuffer(MAXFULLPATH);
        if( lpstr )
        {
            systemtime_to_date_str(&sysTime, lpstr, wFormat);
            strFileDate.ReleaseBuffer();
        }
    }
 
    if(!strFileDate.IsEmpty())
        printf("The file is modified in %s",strFileDate);
    else
        printf("error, the file does not exits");
}

EX2

int GetFileModificationDate_ex2()
{            
    string strTempFile;
    string strFileDate;
    
    GetTempFileName(strTempFile,"ABC");
    strFileDate = GetFileModificationDate(strTempFile);
    
    if(!strFileDate.IsEmpty())
        printf("The file is modified in %s",strFileDate);
    else
        printf("error, the file does not exits");
    return 0;
}