função CM_Enumerate_Classes (cfgmgr32.h)

A função CM_Enumerate_Classes , quando chamada repetidamente, enumera as classes de dispositivo instaladas do computador local fornecendo o GUID de cada classe.

Sintaxe

CMAPI CONFIGRET CM_Enumerate_Classes(
  [in]  ULONG  ulClassIndex,
  [out] LPGUID ClassGuid,
  [in]  ULONG  ulFlags
);

Parâmetros

[in] ulClassIndex

Índice fornecido pelo chamador na lista de classes de dispositivo do computador. Para obter mais informações, consulte a seção Comentários.

[out] ClassGuid

Endereço fornecido pelo chamador de uma estrutura GUID (descrito no SDK do Microsoft Windows) para receber o GUID de uma classe de dispositivo.

[in] ulFlags

Começando com Windows 8, os chamadores podem especificar os seguintes sinalizadores:

CM_ENUMERATE_CLASSES_INSTALLER

Enumerar classes de configuração de dispositivo.

CM_ENUMERATE_CLASSES_INTERFACE

Enumerar classes de interface do dispositivo.

Caso contrário, deve ser definido como zero.

Retornar valor

Se a operação for bem-sucedida, a função retornará CR_SUCCESS. Caso contrário, ele retornará um dos códigos de erro prefixados por CR_ definidos em Cfgmgr32.h.

Comentários

Para enumerar as classes de dispositivo do computador local, chame CM_Enumerate_Classes repetidamente, começando com um valor ulClassIndex de zero e incrementando o valor de índice com cada chamada subsequente até que a função retorne CR_NO_SUCH_VALUE. Alguns valores de índice podem representar entradas de lista que contêm dados de classe inválidos; nesse caso, a função retorna CR_INVALID_DATA. Esse valor retornado pode ser ignorado.

Os GUIDs de classe obtidos dessa função podem ser usados como entrada para as funções de instalação do dispositivo.

Começando com Windows 8 e sistemas operacionais posteriores, os chamadores podem usar o membro ulFlags para especificar quais classes de dispositivo CM_Enumerate_Classes devem retornar. Antes de Windows 8, CM_Enumerate_Classes retornava apenas classes de configuração do dispositivo.

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	cfgmgr32.h (inclua Cfgmgr32.h)
Biblioteca	Cfgmgr32.lib
DLL	Cfgmgr32.dll

Confira também

CM_Enumerate_Classes_Ex