<Return[G]><Top>

GetFileAttributes

Declare Function Api_GetFileAttributes& Lib "kernel32" Alias "GetFileAttributesA" (ByVal lpFileName$)

Declare Function GetFileAttributes Lib "kernel32" Alias "GetFileAttributesA" (ByVal lpFileName As String) As Long

指定されたファイルまたはディレクトリの属性を取得する。
この関数は、FAT 形式の一連の属性情報を取得する。GetFileAttributesEx 関数は、ファイルやディレクトリの他の一連の属性情報を取得する。

パラメータ
lpFileName
    ファイル名またはディレクトリ名を保持している、NULL で終わる文字列へのポインタを指定する。
    Windows NT/2000:この関数の ANSI 版では、名前は最大 MAX_PATH 文字に制限されている。

    この制限をほぼ 32,000 ワイド文字へ拡張するには、この関数の Unicode 版を呼び出し、パスの前に "\\?\" という接頭辞を追加する。
    Windows 95/98:文字列の長さは、最大 MAX_PATH 文字。

戻り値
    関数が成功すると、指定したファイルまたはディレクトリの属性が返る。
    関数が失敗すると、-1 が返る。拡張エラー情報を取得するには、GetLastError 関数を使う。
    属性は、次の値のいずれかまたは任意の組み合わせになる。

    属性                                                    

意味                                                                                                                    

    FILE_ATTRIBUTE_ARCHIVE

アーカイブファイルまたはアーカイブディレクトリである。アプリケーションはこの属性を、ファイルのバ

ックアップや削除のためのマークとして使う。

    FILE_ATTRIBUTE_COMPRESSED

指定されたファイルまたはディレクトリは圧縮されている。ファイルの場合、ファイル内の全データが

圧縮されていることを意味する。ディレクトリの場合、そのディレクトリ内に新しく作成されるファイル

またはサブディレクトリが、既定で圧縮状態になることを意味する。

    FILE_ATTRIBUTE_DEVICE

予約済み。使わないこと。

    FILE_ATTRIBUTE_DIRECTORY

指定されたハンドルは、ディレクトリに関連している。

    FILE_ATTRIBUTE_ENCRYPTED

指定されたファイルまたはディレクトリは暗号化されている。ファイルの場合、ファイル内の全データ

ストリームが暗号化されていることを意味する。ディレクトリの場合、そのディレクトリ内に新しく作

成されるファイルまたはサブディレクトリが、既定で暗号化状態になることを意味する。

    FILE_ATTRIBUTE_HIDDEN

隠しファイルまたは隠しディレクトリである。通常のディレクトリリスティングでは表示されない。

    FILE_ATTRIBUTE_NORMAL

指定されたファイルまたはディレクトリには、特に属性はない。単独で返った場合にのみ、この属

性は有効である。

    FILE_ATTRIBUTE_NOT_CONTENT_INDEXED

Windows 2000:このファイルは、「インデックスサービス」の対象になっていない。

    FILE_ATTRIBUTE_OFFLINE

Windows 2000:このファイルのデータは、すぐには利用できない。この属性は、ファイルのデータ

 

がオフラインの記憶装置へ物理的に移動されたことを示す。この属性は、Windows 2000 の階

 

層記憶管理ソフトウェアである「リモート記憶域」が利用するものである。アプリケーションは、任

 

意にこの属性を変更するべきではない。

    FILE_ATTRIBUTE_READONLY

このファイルまたはディレクトリは読み取り専用である。アプリケーションはこのファイルの読み取りを

 

行えるが、書き込みや削除はできない。ディレクトリの場合、アプリケーションは削除を行えない。

    FILE_ATTRIBUTE_REPARSE_POINT

このファイルには、再解析ポイントが関連付けられている。

    FILE_ATTRIBUTE_SPARSE_FILE

このファイルは、スパースファイル(疎なファイル、未使用の領域が多い、または同じ値が長く続

 

くファイル)である。

    FILE_ATTRIBUTE_SYSTEM

このファイルまたはディレクトリは、オペレーティングシステムの一部、またはオペレーティングシス

 

テム専用である。

    FILE_ATTRIBUTE_TEMPORARY

このファイルは、一時ファイルとして使われている。ファイルシステムは、データをハードディスクの

 

ような大容量記憶装置へ書き込む代わりに、高速なアクセスが行えるよう、すべてのデータをメモ

 

リ内に維持することを試みる。アプリケーションは、必要がなくなった段階で一時ファイルをすぐに

 

削除すること。