SetupDiGetClassBitmapIndex 函式 (setupapi.h)

  • 發行項

SetupDiGetClassBitmapIndex 函式會擷取指定類別所提供的迷你圖示索引。

語法

WINSETUPAPI BOOL SetupDiGetClassBitmapIndex(
  [in, optional] const GUID *ClassGuid,
  [out]          PINT       MiniIconIndex
);

參數

[in, optional] ClassGuid

要擷取迷你圖示之 裝置安裝類別 GUID 的指標。 此指標是選擇性的，可以是 NULL。

[out] MiniIconIndex

INT 類型的變數指標，可接收指定裝置安裝類別之迷你圖示的索引。 如果 ClassGuid 參數為 NULL ，或指定類別沒有迷你圖示， SetupDiGetClassBitmapIndex 會傳回未知裝置安裝類別之迷你圖標的索引。

傳回值

如果指定的裝置安裝類別有最小圖示， SetupDiGetClassBitmapIndex 會傳回 TRUE。 否則，此函式會傳回 FALSE ，而且可以透過呼叫 GetLastError 來擷取記錄的錯誤。 如果 ClassGuid 參數為 NULL，或指定類別沒有迷你圖示，則函式會傳回 FALSE ，而 GetLastError 會傳回ERROR_NO_DEVICE_ICON。

備註

如需裝置安裝類別迷你圖示及其對應索引的清單，請參閱 SetupDiDrawMiniIcon。

規格需求

需求 值
最低支援的用戶端 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。
目標平台 桌面
標頭 setupapi.h (包括 Setupapi.h)
程式庫 Setupapi.lib
Dll Setupapi.dll

另請參閱

SetupDiDrawMiniIcon

SetupDiLoadClassIcon