SHFILEINFOA 結構 (shellapi.h)

包含檔案對象的相關信息。

語法

typedef struct _SHFILEINFOA {
  HICON hIcon;
  int   iIcon;
  DWORD dwAttributes;
  CHAR  szDisplayName[MAX_PATH];
  CHAR  szTypeName[80];
} SHFILEINFOA;

成員

hIcon

類型: HICON

代表檔案之圖標的句柄。 當您不再需要此句柄時,您必須負責使用 DestroyIcon 終結此句柄。

iIcon

類型: int

系統映射清單中的圖示影像索引。

dwAttributes

類型: DWORD

值的陣列,表示檔案物件的屬性。 如需這些值的相關信息,請參閱 IShellFolder::GetAttributesOf 方法。

szDisplayName[MAX_PATH]

類型: TCHAR[MAX_PATH]

字串,其中包含出現在 Windows Shell 中的檔名,或是包含代表檔案之圖示之檔案的路徑和檔名。

szTypeName[80]

類型: TCHAR[80]

描述檔類型的字串。

備註

這個結構會與 SHGetFileInfo 函式搭配使用。

注意

shellapi.h 標頭會將 SHFILEINFO 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例

規格需求

需求
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 shellapi.h