SetupDiLoadClassIcon 函式 (setupapi.h)
SetupDiLoadClassIcon函式會同時載入指定類別的大型和走勢圖標。
語法
WINSETUPAPI BOOL SetupDiLoadClassIcon(
[in] const GUID *ClassGuid,
[out, optional] HICON *LargeIcon,
[out, optional] PINT MiniIconIndex
);
參數
[in] ClassGuid
應該載入圖示 () 類別的 GUID 指標。
[out, optional] LargeIcon
圖示控制碼的指標，可接收所載入大型圖示的指定類別的控制碼值。 此指標是選擇性的，可以是 Null。 如果指標為 Null，則不會載入大型圖示。
[out, optional] MiniIconIndex
INT 型別變數的指標，可接收指定類別之走勢圖標的索引。 走勢圖標會儲存在裝置安裝程式的走勢圖標快取中。 指標是選擇性的，可以是 Null。
傳回值
如果函式成功，函式會傳回 TRUE 。 否則，它會傳回 FALSE ，而且可以透過呼叫 GetLastError來擷取記錄的錯誤。
備註
類別的圖示是預先定義並從裝置安裝程式的內部快取載入，或直接從類別安裝程式的可執行檔載入它們。 此函式會查詢指定類別區段中的登錄值 ICON 。 如果已指定 ICON 值，它會指出要載入的走勢圖標。
如果 ICON 值是負數，則絕對值代表類別登錄中預先定義的圖示。 如需預先定義的走勢圖標清單，請參閱 SetupDiDrawMiniIcon 。
如果 ICON 值為正數，則表示將擷取類別安裝程式可執行檔映射中的圖示。 值 1 是保留的。 此函式也會使用 INSTALLER32 登錄值，然後 ENUMPROPPAGES32 登錄值來判斷要從中擷取圖示的可執行映射。 如需這些登錄值的詳細資訊，請參閱 INF ClassInstall32 一節。
當呼叫端使用圖示完成時，呼叫端必須呼叫DestroyIcon (，如Microsoft Windows SDK檔) 所述。
如果指定 LargeIcon 參數，但 ClassGuid 參數不提供有效的類別 GUID 或 類別的 Icon 登錄值無效， 則 SetupDiLoadClassIcon 會載入預設大型圖示、傳回大型圖示的控制碼，如果指定 MiniIconIndex 參數，則會傳回預設走勢圖標的索引。
規格需求
| 最低支援的用戶端 | 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。 |
| 目標平台 | 桌上型 |
| 標頭 | setupapi.h (包括 Setupapi.h) |
| 程式庫 | Setupapi.lib |
| Dll | Setupapi.dll |