_fstat, _fstat32, _fstat64, _fstati64, _fstat32i64, _fstat64i32

取得開啟之檔案的相關資訊。

語法

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

參數

fd
已開啟之檔案的檔案描述項。

buffer
儲存結果的結構指標。

傳回值

如果取得檔案狀態資訊，則傳回 0。 -1 的傳回值表示錯誤。 如果檔案描述元無效或 buffer 為 NULL，則會叫用無效的參數處理常式，如參數驗證中所述。 如果允許繼續執行，在檔案描述元無效的情形中，errno 會設為 EBADF，如果 buffer 為 NULL，則會設為 EINVAL。

備註

_fstat 函式會取得與 fd 相關聯之開啟的檔案的相關資訊，並將它儲存在 buffer 結構中。 定義於 SYS\Stat.h 中，_stat 結構包含下列欄位。

欄位	意義
st_atime	最後存取檔案的時間。
st_ctime	建立檔案的時間。
st_dev	如果是裝置，則為 fd，否則為 0。
st_mode	檔案模式資訊的位元遮罩。 如果 fd 指的是裝置，則會設定 _S_IFCHR 位元。 如果 fd 指的是一般檔案，則會設定 _S_IFREG 位元。 讀取/寫入位元會根據檔案的權限模式設定。 _S_IFCHR 和其他常數於 SYS\Stat.h 中定義。
st_mtime	檔案的上次修改時間。
st_nlink	在非 NTFS 檔案系統上一律為 1。
st_rdev	如果是裝置，則為 fd，否則為 0。
st_size	檔案大小，以位元組為單位。

如果 fd 指的是裝置，則 st_atime、st_ctime、st_mtime和st_size 欄位並沒有意義。

因為 Stat.h 會使用 Types.h 中定義的 _dev_t 類型，因此您必須在程式碼中的 Stat.h 之前包含 Types.h。

使用 _stat64 結構的 _fstat64，允許表示至3000 年 12 月 31 日 23:59:59 UTC 為止的日期；而其他函式只能表示至 2038 年 1 月 18 日23:59:59 UTC 的日期。 1970 年 1 月 1 日午夜是所有這些函式的日期範圍下限。

這些函式的變化支援 32 位元或 64 位元時間類型，以及 32 位元或 64 位元檔案長度。 第一個數值後置字元 (32 或 64) 表示所使用的時間類型大小，第二個後置字元為 i32 或 i64，表示檔案大小是以 32 位元或 64 位元整數來表示。

除非 _USE_32BIT_TIME_T 已定義，否則 _fstat 等於 _fstat64i32，且 _stat 包含 64 位元時間。 定義 _USE_32BIT_TIME_T 時，_fstat 會使用 32 位元時間，且 _stat 會包含 32 位元時間。 對於 _fstati64也是如此。

根據預設，此函式的全域狀態會限定於應用程式。 若要變更此行為，請參閱 CRT 中的全域狀態。

_stat 的時間類型和檔案長度類型變數

函式	已定義 _USE_32BIT_TIME_T 嗎？	時間類型	檔案長度類型
_fstat	未定義	64 位元	32 位元
_fstat	已定義	32 位元	32 位元
_fstat32	不會受到巨集定義的影響	32 位元	32 位元
_fstat64	不會受到巨集定義的影響	64 位元	64 位元
_fstati64	未定義	64 位元	64 位元
_fstati64	已定義	32 位元	64 位元
_fstat32i64	不會受到巨集定義的影響	32 位元	64 位元
_fstat64i32	不會受到巨集定義的影響	64 位元	32 位元

需求

函式	必要的標頭
_fstat	<sys/stat.h> 和 <sys/types.h>
_fstat32	<sys/stat.h> 和 <sys/types.h>
_fstat64	<sys/stat.h> 和 <sys/types.h>
_fstati64	<sys/stat.h> 和 <sys/types.h>
_fstat32i64	<sys/stat.h> 和 <sys/types.h>
_fstat64i32	<sys/stat.h> 和 <sys/types.h>

如需相容性詳細資訊，請參閱相容性。

範例

// 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

另請參閱

檔案處理
_access、_waccess
_chmod、_wchmod
_filelength、_filelengthi64
_stat、_wstat 函式