CFile::GetStatus

Artigo
08/25/2010

Este método recupera informações de status relacionadas a um determinado CFile instância do objeto ou um determinado caminho de arquivo.

BOOL GetStatus(
   CFileStatus& rStatus 
) const;
static BOOL PASCAL GetStatus(
   LPCTSTR lpszFileName,
   CFileStatus& rStatus 
);

Parâmetros

rStatus
Uma referência a um usuário fornecido CFileStatus estrutura que receberá as informações de status.The CFileStatus estrutura possui os seguintes campos:
- CTime m_ctime A data e time em que o arquivo foi criado.
- CTime m_mtime A data e time em que o arquivo foi modificado pela última vez.
- CTime m_atime A data e time em que o arquivo foi acessado pela última vez para leitura.
- ULONGLONG m_size O dimensionar lógico do arquivo em bytes, conforme relatado pelo comando DIR.
- BYTE m_attribute O byte de atributo do arquivo.
- m_szFullName char [_MAX_PATH O nome de arquivo absoluto do Windows conjunto de caractere.
lpszFileName
Uma seqüência de caractere em caractere do Windows isto é define o caminho para o arquivo desejado.O caminho pode ser relativo ou absoluto, ou ele pode conter um nome de caminho de rede.

Valor de retorno

TRUE se as informações de status para o arquivo especificado obtidos com êxito; caso contrário, FALSE.

Comentários

A versão não-estático de GetStatus recupera as informações de status do arquivo em aberto associado a determinado CFile objeto. A versão estática de GetStatus obtém o status do arquivo de um determinado caminho de arquivo sem realmente abrir o arquivo.Isso é útil para testar os existência e direitos de acesso de um arquivo.

The m_attribute membro do CFileStatus estrutura refere-se ao conjunto de atributos de arquivo.The CFile classe fornece o Atributo tipo de enumeração para que atributos de arquivo podem ser especificados symbolically:

enum Attribute {

normal = 0x00,

readOnly = 0x01,

hidden = 0x02,

system = 0x04,

volume = 0x08,

directory = 0x10,

archive = 0x20

};

Exemplo

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