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

另請參閱

SetupDiDrawMiniIcon

SetupDiGetClassBitmapIndex