Função SetupDiGetClassBitmapIndex (setupapi.h)

  • Artigo

A função SetupDiGetClassBitmapIndex recupera o índice do mini-ícone fornecido para a classe especificada.

Sintaxe

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

Parâmetros

[in, optional] ClassGuid

Um ponteiro para o GUID da classe de configuração do dispositivo para o qual recuperar o mini-ícone. Esse ponteiro é opcional e pode ser NULL.

[out] MiniIconIndex

Um ponteiro para uma variável do tipo INT que recebe o índice do mini-ícone para a classe de configuração de dispositivo especificada. Se o parâmetro ClassGuid for NULL ou se não houver nenhum miniícone para a classe especificada, SetupDiGetClassBitmapIndex retornará o índice do mini-ícone para a classe de configuração de dispositivo Desconhecido.

Retornar valor

Se houver um ícone mínimo para a classe de configuração de dispositivo especificada, SetupDiGetClassBitmapIndex retornará TRUE. Caso contrário, essa função retornará FALSE e o erro registrado poderá ser recuperado com uma chamada para GetLastError. Se o parâmetro ClassGuid for NULL ou se não houver nenhum mini-ícone para a classe especificada, a função retornará FALSE e GetLastError retornará ERROR_NO_DEVICE_ICON.

Comentários

Para obter uma lista dos mini-ícones da classe de configuração do dispositivo e seus índices correspondentes, consulte SetupDiDrawMiniIcon.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Microsoft Windows 2000 e versões posteriores do Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho setupapi.h (inclua Setupapi.h)
Biblioteca Setupapi.lib
DLL Setupapi.dll

Confira também

SetupDiDrawMiniIcon

SetupDiLoadClassIcon