SHCOLUMNDATA 構造体 (shlobj.h)

[アーティクル]
03/02/2024

特定のファイルを識別する情報が含まれます。これは、特定のファイルのデータを要求するときに IColumnProvider::GetItemData によって使用されます。

構文

typedef struct {
  ULONG dwFlags;
  DWORD dwFileAttributes;
  ULONG dwReserved;
  WCHAR *pwszExt;
  WCHAR wszFile[MAX_PATH];
} SHCOLUMNDATA, *LPSHCOLUMNDATA;

メンバー

dwFlags

種類: ULONG

要求の性質を指定するために使用されるフラグ。

SHCDF_UPDATEITEM

wszFile で指定されたファイルは、IColumnProvider::GetItemData の最後の呼び出し以降に変更された新しいファイルまたはファイルです。キャッシュされたデータはすべてフラッシュして再計算する必要があります。データをキャッシュしない列ハンドラー、またはファイルとは別に格納されているデータを表示する列ハンドラーは、このフラグを無視できます。

dwFileAttributes

型: DWORD

ファイル属性フラグ。次の値の 1 つ以上になります。

FILE_ATTRIBUTE_ARCHIVE

ファイルまたはディレクトリはアーカイブファイルまたはディレクトリです。アプリケーションでは、この属性を使用して、バックアップまたは削除の対象にファイルをマークします。

FILE_ATTRIBUTE_COMPRESSED

ファイルまたはディレクトリが圧縮されます。ファイルの場合、これはファイル内のすべてのデータが圧縮されることを意味します。ディレクトリの場合は、圧縮が新しく作成されたファイルとサブディレクトリの既定値であることを意味します。

FILE_ATTRIBUTE_DIRECTORY

ハンドルはディレクトリを識別します。

FILE_ATTRIBUTE_ENCRYPTED

ファイルまたはディレクトリは暗号化されています。ファイルの場合、これはファイル内のすべてのデータストリームが暗号化されることを意味します。ディレクトリの場合、これは、新しく作成されたファイルとサブディレクトリの暗号化が既定であることを意味します。

FILE_ATTRIBUTE_HIDDEN

ファイルまたはディレクトリは非表示です。通常のディレクトリ一覧には含まれません。

FILE_ATTRIBUTE_NORMAL

ファイルまたはディレクトリには他の属性が設定されていません。この属性は、単独で使用された場合にのみ有効です。

FILE_ATTRIBUTE_OFFLINE

オフラインのファイルのデータは、即時には使用できません。この属性は、ファイルデータが物理的にオフラインストレージに移動されたことを示します。この属性は、Windows 2000 の階層ストレージ管理ソフトウェアである Remote Storage によって使用されます。この属性が設定されている場合は、ファイルがオフラインストレージから呼び出されるため、列ハンドラーはファイルを開かないようにする必要があります。

FILE_ATTRIBUTE_READONLY

ファイルまたはディレクトリは読み取り専用です。アプリケーションはファイルを読み取ることができますが、ファイルに書き込んだり削除したりすることはできません。ディレクトリの場合、アプリケーションはディレクトリを削除できません。

FILE_ATTRIBUTE_REPARSE_POINT

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

FILE_ATTRIBUTE_SPARSE_FILE

ファイルはスパースファイルです。

FILE_ATTRIBUTE_SYSTEM

ファイルまたはディレクトリは、オペレーティングシステムの一部であるか、またはオペレーティングシステムによって排他的に使用されます。

FILE_ATTRIBUTE_TEMPORARY

ファイルは一時ストレージに使用されています。ファイルシステムは、データを大容量ストレージにフラッシュするのではなく、すべてのデータをメモリに保持するよう試みて、すばやくアクセスできるようにします。一時ファイルが不要になったら、アプリケーションが直ちに削除する必要があります。

dwReserved

種類: ULONG

予約済み。 NULL に設定します。

pwszExt

種類: WCHAR*

ファイル名拡張子を持つ null で終わる Unicode 文字列へのポインター。

wszFile[MAX_PATH]

種類: WCHAR[MAX_PATH]

完全修飾ファイルパスを含む null で終わる Unicode 文字列。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
Header	shlobj.h

こちらもご覧ください

GetFileAttributes