CFile::GetStatus

Článek
03/04/2013

Tato metoda načte informace o stavu týkající dané CFile instance objektu nebo cestu k souboru.

BOOL GetStatus(
   CFileStatus& rStatus 
) const;
static BOOL PASCAL GetStatus(
   LPCTSTR lpszFileName,
   CFileStatus& rStatus,
   CAtlTransactionManager* pTM = NULL
);

Parametry

rStatus
Odkaz na uživatelem zadané CFileStatus struktury, který bude přijímat informace o stavu.CFileStatus struktura obsahuje následující pole:
- CTime m_ctime datum a čas vytvoření souboru.
- CTime m_mtime datum a čas poslední změny souboru.
- CTime m_atime datum a čas posledního přístupu k souboru pro čtení.
- ULONGLONG m_size logická velikost souboru v bajtech, vykázání příkazu DIR.
- BAJT m_attribute byte atribut souboru.
- char [_MAX_PATH] m_szFullName absolutní název znakové sady.
lpszFileName
Řetězec znaků systému Windows je cestu nastavit požadovaný soubor.Cesta může být relativní nebo absolutní nebo názvu síťové cesty může obsahovat.
pTM
Ukazatel na objekt CAtlTransactionManager

Vrácená hodnota

TRUE Pokud je úspěšně získat informace o stavu pro zadaný soubor; jinak FALSE.

Poznámky

Nestatický verzi GetStatus získá stavové informace přidružené k otevření souboru dané CFile objektu.Statické verzi GetStatus získá stav souboru bez skutečně otevírání souborů z daného souboru cesty.To je užitečné pro testování existence a přístupových práv souboru.

M_attribute člena CFileStatus struktury odkazuje na sadu atributů souboru. CFile Třída poskytuje atributu výčtu zadejte tak symbolicky lze určit atributy souborů:

enum Attribute {

normal = 0x00,

readOnly = 0x01,

hidden = 0x02,

system = 0x04,

volume = 0x08,

directory = 0x10,

archive = 0x20

};

Příklad

CFile cfile;
cfile.Open(_T("SetLength_File.dat"), CFile::modeCreate |
   CFile::modeReadWrite);
ULONGLONG dwNewLength = 10000;
cfile.SetLength(dwNewLength);
CFileStatus status;
if(cfile.GetStatus(status))    // virtual member function
{
   TRACE(_T("File size = %u\n"), status.m_size);
}
TCHAR* pszFileName = _T("SetLength_File.dat");
if(CFile::GetStatus(pszFileName, status))   // static function
{
   TRACE(_T("Full file name = %s\n"), status.m_szFullName);
}