Função CM_Enumerate_Enumerators_ExA (cfgmgr32.h)

  • Artigo

[A partir do Windows 8 e do Windows Server 2012, essa função foi preterida. Em vez disso, use CM_Enumerate_Enumerators .]

A função CM_Enumerate_Enumerators_Ex enumera os enumeradores de dispositivo de um computador local ou remoto, fornecendo o nome de cada enumerador.

Sintaxe

CMAPI CONFIGRET CM_Enumerate_Enumerators_ExA(
  [in]           ULONG    ulEnumIndex,
  [out]          PSTR     Buffer,
  [in, out]      PULONG   pulLength,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parâmetros

[in] ulEnumIndex

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

[out] Buffer

Endereço de um buffer para receber um nome de enumerador. Esse buffer deve ser MAX_DEVICE_ID_LEN dimensionado (ou, defina Buffer como zero e obtenha o comprimento real do nome no local referenciado por puLength).

[in, out] pulLength

Endereço fornecido pelo chamador de um local para manter o tamanho do buffer. O chamador fornece o comprimento do buffer apontado pelo Buffer. A função substitui esse valor pelo tamanho real da cadeia de caracteres de nome do enumerador. Se o tamanho do buffer fornecido pelo chamador for muito pequeno, a função fornecerá o tamanho do buffer necessário e retornará CR_BUFFER_SMALL.

[in] ulFlags

Não usado, deve ser 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 a partir do Windows 8 e do Windows Server 2012, pois essa funcionalidade foi removida.
 

Valor retornado

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 os enumeradores de dispositivo local ou de um computador remoto, chame CM_Enumerate_Enumerators_Ex repetidamente, começando com um valor de índice ulEnumIndex igual a zero e incrementando o valor do índice com cada chamada subsequente até que a função retorne CR_NO_SUCH_VALUE.

Depois que os nomes do enumerador forem obtidos, os nomes poderão ser usados como entrada para CM_Get_Device_ID_List.

A funcionalidade para acessar computadores remotos foi removida nos 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

   
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

Confira também

CM_Enumerate_Enumerators