CFile::GetStatus

Artikel
02/26/2013

Diese Methode ruft den Status ab, die einer angegebenen CFile-Objektinstanz oder einem angegebenen Dateipfad bereitgestellt.

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

Parameter

rStatus
Ein Verweis auf eine vom Benutzer bereitgestellten CFileStatus-Struktur, die die Statusinformationen abruft.Die CFileStatus-Struktur hat die folgenden Felder:
- CTime m_ctime das Datum und die Uhrzeit, die die Datei erstellt wurde.
- CTime m_mtime das Datum und die Uhrzeit die Datei war Auslastung aufgenommen werden.
- CTime m_atime das Datum und die Uhrzeit, die auf die Datei zuletzt zum Lesen zugegriffen wurde.
- ULONGLONG m_size die logische Größe der Datei in Bytes, wie durch den DIR-Befehl gemeldet.
- BYTE m_attribute das Attributbyte der Datei.
- char m_szFullName[_MAX_PATH] der absolute Dateiname im Windows-Zeichensatz.
lpszFileName
Eine Zeichenfolge im Windows-Zeichensatz, der der Pfad zur gewünschten Datei ist.Der Pfad kann relativ oder absolut sein, oder er kann einen Netzwerkpfadnamen enthalten.
pTM
Zeiger auf CAtlTransactionManager-Objekt

Rückgabewert

TRUE, wenn die Statusinformationen für die angegebene Datei erfolgreich abgerufen werden; andernfalls FALSE.

Hinweise

Die nicht statische Version von GetStatus ruft Statusinformationen der geöffneten Datei ab, die dem angegebenen CFile-Objekt zugeordnet ist.Die statische Version von GetStatus ruft den Dateistatus aus einem angegebenen Dateipfad, ohne die Datei tatsächlich zu öffnen.Dies ist zum Testen des Vorhandenseins und der Zugriffsrechte einer Datei hilfreich.

Der m_attribute-Member der Struktur CFileStatus bezieht sich auf den Dateiattributsatz an.Die Klasse stellt den CFileAttribute-Enumerationstyp, sodass Dateiattribute symbolisch angegeben werden:

enum Attribute {

normal = 0x00,

readOnly = 0x01,

hidden = 0x02,

system = 0x04,

volume = 0x08,

directory = 0x10,

archive = 0x20

};

Beispiel

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