_fstat, _fstat32, _fstat64, _fstati64, _fstat32i64_fstat64i32

Ottiene informazioni su un file aperto.

Sintassi

int _fstat(
   int fd,
   struct _stat *buffer
);
int _fstat32(
   int fd,
   struct _stat32 *buffer
);
int _fstat64(
   int fd,
   struct _stat64 *buffer
);
int _fstati64(
   int fd,
   struct _stati64 *buffer
);
int _fstat32i64(
   int fd,
   struct _stat32i64 *buffer
);
int _fstat64i32(
   int fd,
   struct _stat64i32 *buffer
);

Parametri

fd
Descrittore di file del file aperto.

buffer
Puntatore alla struttura per l'archiviazione dei risultati.

Valore restituito

Restituisce 0 se si ottengono le informazioni sullo stato dei file. Il valore restituito -1 indica un errore. Se il descrittore di file non è valido o buffer è NULL, viene richiamato il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, errno è impostata su EBADF per un descrittore di file non valido o su EINVAL se buffer è NULL.

Osservazioni:

La funzione _fstat ottiene informazioni sul file aperto associato a fd e le archivia nella struttura a cui punta buffer. La _stat struttura, definita in SYS\Stat.h, contiene i campi seguenti.

Se fd fa riferimento a un dispositivo, i st_atimecampi , st_ctimest_mtime, e st_size non sono significativi.

Poiché Stat.h usa il _dev_t tipo , definito in Types.h, è necessario includere Types.h prima Stat.h nel codice.

_fstat64, che usa la struttura _stat64, consente di esprimere le date di creazione di file fino alle 23.59.59 del 31 dicembre 3000 UTC, mentre le altre funzioni rappresentano solo le date fino alle 23.59.59 del 18 gennaio 2038 UTC. Il limite inferiore dell'intervallo di date per tutte queste funzioni è Mezzanotte, 1 gennaio 1970.

Le variazioni di queste funzioni supportano tipi time a 32 o 64 bit e lunghezze di file a 32 o a 64 bit. Il primo suffisso numerico (32 o 64) indica le dimensioni del tipo time usato; il secondo suffisso è i32 o i64, che indica se le dimensioni del file sono rappresentate come intero a 32 bit o 64 bit.

A meno che _USE_32BIT_TIME_T non sia definito, _fstat è equivalente a _fstat64i32e _stat contiene un tempo a 64 bit. Quando _USE_32BIT_TIME_T viene definito, _fstat usa un'ora a 32 bit e _stat contiene un tempo a 32 bit. Lo stesso vale per _fstati64.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Variazioni del tipo di tempo e del tipo di lunghezza del file _stat

Requisiti

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Esempio

// crt_fstat.c
// This program uses _fstat to report
// the size of a file named F_STAT.OUT.

#include <io.h>
#include <fcntl.h>
#include <time.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <errno.h>
#include <share.h>

int main( void )
{
   struct _stat buf;
   int fd, result;
   char buffer[] = "A line to output";
   char timebuf[26];
   errno_t err;

   _sopen_s( &fd,
             "f_stat.out",
             _O_CREAT | _O_WRONLY | _O_TRUNC,
             _SH_DENYNO,
             _S_IREAD | _S_IWRITE );
   if( fd != -1 )
      _write( fd, buffer, strlen( buffer ) );

   // Get data associated with "fd":
   result = _fstat( fd, &buf );

   // Check if statistics are valid:
   if( result != 0 )
   {
      if (errno == EBADF)
        printf( "Bad file descriptor.\n" );
      else if (errno == EINVAL)
        printf( "Invalid argument to _fstat.\n" );
   }
   else
   {
      printf( "File size     : %ld\n", buf.st_size );
      err = ctime_s(timebuf, 26, &buf.st_mtime);
      if (err)
      {
         printf("Invalid argument to ctime_s.");
         exit(1);
      }
      printf( "Time modified : %s", timebuf );
   }
   _close( fd );
}

File size     : 16
Time modified : Wed May 07 15:25:11 2003

Vedi anche

Gestione dei file
_access, _waccess
_chmod, _wchmod
_filelength, _filelengthi64
_stat, _wstat funzioni