CFile::GetStatus

Articolo
03/26/2013

Questo metodo recupera lo stato correlate a un'istanza di oggetto specificato CFile o un percorso file specificato.

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

Parametri

rStatus
Un riferimento a una struttura fornita dall'utente CFileStatus che riceverà le informazioni sullo stato.La struttura CFileStatus dispone dei seguenti campi:
- CTime m_ctime la data e l'ora in cui è stato creato.
- CTime m_mtime la data e l'ora dell'ultima modifica.
- CTime m_atime la data e l'ora in cui è stato ultimo accesso per indicare.
- ULONGLONG m_size la logica dimensione in byte del file, come indicato dal comando DIR.
- BYTE m_attribute il byte di attributi del file.
- char m_szFullName[_MAX_PATH] il nome file assoluto del set di caratteri Windows.
lpszFileName
Una stringa nel set di caratteri di Windows che è il percorso del file desiderato.Il percorso può essere relativo o assoluto, oppure può contenere un nome di percorso di rete.
pTM
Puntatore all'oggetto di CAtlTransactionManager

Valore restituito

TRUE se le informazioni di stato per il file specificato correttamente vengono ottenute; in caso contrario, FALSE.

Note

La versione di non statico GetStatus recupera le informazioni sullo stato del file aperto associato all'oggetto specificato CFile.La versione di GetStatus ottiene lo stato del file da un percorso file specificato senza aprire il file.Ciò è utile per verificare l'esistenza e i diritti di accesso di un file.

Il membro m_attribute della struttura CFileStatus si riferisce al set di attributi del file.La classe CFile fornisce il tipo di enumerazione Attributo in modo dagli attributi del file è possibile specificare simbolicamente:

enum Attribute {

normal = 0x00,

readOnly = 0x01,

hidden = 0x02,

system = 0x04,

volume = 0x08,

directory = 0x10,

archive = 0x20

};

Esempio

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);
}