função CM_Enumerate_Classes_Ex (cfgmgr32.h)

[Começando com Windows 8 e Windows Server 2012, essa função foi preterida. Em vez disso, use CM_Enumerate_Classes .]

A função CM_Enumerate_Classes_Ex , quando chamada repetidamente, enumera classes de dispositivo instaladas de um computador local ou remoto, fornecendo o GUID de cada classe.

Sintaxe

CMAPI CONFIGRET CM_Enumerate_Classes_Ex(
  [in]           ULONG    ulClassIndex,
  [out]          LPGUID   ClassGuid,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

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 a seguir.

[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.

[in, optional] hMachine

Identificador de computador fornecido pelo chamador, obtido de uma chamada anterior para CM_Connect_Machine.

Nota Não há suporte para o uso dessa função para acessar computadores remotos, começando com Windows 8 e Windows Server 2012, pois essa funcionalidade foi removida.

 

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 local ou de um computador remoto, chame CM_Enumerate_Classes_Ex repetidamente, começando com um valor de índice 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_Ex devem retornar. Antes de Windows 8, CM_Enumerate_Classes_Ex retornava apenas classes de configuração do dispositivo.

A funcionalidade para acessar computadores remotos foi removida em sistemas operacionais Windows 8 e Windows Server 2012 e posteriores, portanto, você não pode acessar computadores remotos durante a execução nessas versões do Windows.

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