Share via


CFile::Rename

この静的関数は、指定されたファイルの名前を変更します。

static void PASCAL Rename(
   LPCTSTR lpszOldName,
   LPCTSTR lpszNewName,
   CAtlTransactionManager* pTM = NULL
);

パラメーター

  • lpszOldName
    ファイルの古いパス名。

  • lpszNewName
    ファイルの新しいパス名。

  • pTM
    CAtlTransactionManager オブジェクトへのポインター。

解説

ディレクトリの名前は変更できません。この関数は、REN コマンドに相当します。

使用例

TCHAR* pOldName = _T("Oldname_File.dat");
TCHAR* pNewName = _T("Renamed_File.dat");

try
{
    CFile::Rename(pOldName, pNewName);
}
catch(CFileException* pEx )
{
    TRACE(_T("File %20s not found, cause = %d\n"), pOldName, 
       pEx->m_cause);
    pEx->Delete();
}

必要条件

ヘッダー : afx.h

参照

関連項目

CFile クラス

階層図