CFile::GetStatus

Artículo
06/10/2015

Este método recupera el estado información relacionada con una instancia de objeto especificada de CFile o una ruta de acceso especificada.

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

Parámetros

rStatus
Una referencia a una estructura usuario-proporcionada de CFileStatus que recibirá la información de estado. La estructura de CFileStatus tiene los siguientes campos:
- Fecha y hora deCTime m_ctime Fabricado el archivo se creó.
- Fecha y hora deCTime m_mtime The de la última modificación.
- Fecha y hora deCTime m_atime Fabricado el archivo se tuvo acceso en último lugar para leer.
- Tamaño lógico deULONGLONG m_size el archivo en bytes, que notifica el comando de DIR.
- Byte del atributo deBYTE m_attribute el archivo.
- Nombre de archivo absoluto dechar m_szFullName[_MAX_PATH] The en el juego de caracteres de Windows.
lpszFileName
Una cadena en el juego de caracteres de Windows que la ruta del archivo deseado. La ruta de acceso puede ser relativa o absoluta, o puede contener un nombre de ruta de acceso a la red.
pTM
Puntero al objeto de CAtlTransactionManager

Valor devuelto

TRUE si la información de estado para el archivo especificado se obtiene correctamente; si no, FALSE.

Comentarios

La versión no estática de la información de estado de recupera de GetStatus de archivo abierto asociado al objeto especificado de CFile . La versión estática de GetStatus obtiene el estado del archivo de una ruta de acceso especificada realmente abrir el archivo. Esto es útil para probar la existencia y derechos de acceso de un archivo.

El miembro de m_attribute de la estructura de CFileStatus hace referencia al conjunto de atributos de archivo. La clase de CFile proporciona el tipo de enumeración de Atributo para que los atributos de archivo se pueden especificar simbólicamente:

enum Attribute {

normal = 0x00,

readOnly = 0x01,

hidden = 0x02,

system = 0x04,

volume = 0x08,

directory = 0x10,

archive = 0x20

};

Ejemplo

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