共用方式為

IShellIconOverlayIdentifier：：GetOverlayInfo 方法 (shobjidl_core.h)

  • 發行項

提供圖示重迭點陣圖的位置。

語法

HRESULT GetOverlayInfo(
  [out] LPWSTR pwszIconFile,
        int    cchMax,
  [out] int    *pIndex,
  [out] DWORD  *pdwFlags
);

參數

[out] pwszIconFile

類型： PWSTR

Null 終止的 Unicode 字串，其中包含包含圖示之檔案的完整路徑。 .dll、.exe 和 .ico 檔案類型都是可接受的。 如果您傳回檔案名 ， 則必須在 pdwFlags 中設定ISIOI_ICONFILE旗標。

cchMax

類型： int

pwszIconFile緩衝區的大小，以 Unicode 字元為單位。

[out] pIndex

類型： int*

索引值的指標，用來識別包含多個圖示的檔案中的圖示。 如果您傳回索引 ， 則必須在 pdwFlags 中設定ISIOI_ICONINDEX旗標。

[out] pdwFlags

類型： DWORD*

點陣圖的指標，指定 方法所傳回的資訊。 此參數可以是下列其中一個或兩個值。

ISIOI_ICONFILE (0x00000001)

圖示檔案的路徑會透過 pwszIconFile傳回。

ISIOI_ICONINDEX (0x00000002)

pwszIconFile中有一個以上的圖示。 圖示的索引會透過 pIndex傳回。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

這個方法是由啟動時的 Shell 呼叫，以便將處理常式的圖示重迭新增至系統映射清單。 初始化完成後，Shell 會在需要顯示處理常式的圖示重迭時呼叫 GetOverlayInfo 。

注意 一旦映射在初始化期間載入系統映射清單，就無法變更。 初始化之後，檔案名和索引只會用來識別圖示重迭。 系統不會載入新的圖示重迭。 呼叫 GetOverlayInfo 時，您的處理常式必須傳回第一次呼叫函式時所指定的相同檔案名和索引。
 

規格需求

   
最低支援的用戶端 Windows 2000 專業版、Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包含 Shlobj.h)
Dll Shell32.dll (5.0 版或更新版本)