Compartilhar via


Função CM_Get_Device_ID_List_ExA (cfgmgr32.h)

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

A função CM_Get_Device_ID_List_Ex recupera uma lista de IDs de instância do dispositivo para as instâncias do dispositivo em um computador local ou remoto.

Sintaxe

CMAPI CONFIGRET CM_Get_Device_ID_List_ExA(
  [in, optional] PCSTR    pszFilter,
  [out]          PZZSTR   Buffer,
  [in]           ULONG    BufferLen,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parâmetros

[in, optional] pszFilter

Ponteiro fornecido pelo chamador para uma cadeia de caracteres que especifica um subconjunto dos identificadores de instância do dispositivo do computador ou NULL. Confira a descrição a seguir de ulFlags.

[out] Buffer

Endereço de um buffer para receber um conjunto de cadeias de caracteres de identificador de instância de dispositivo terminadas em NULL. O final do conjunto é encerrado por um NULL extra. O tamanho do buffer necessário deve ser obtido chamando CM_Get_Device_ID_List_Size_Ex.

[in] BufferLen

Comprimento fornecido pelo chamador, em caracteres, do buffer especificado por Buffer.

[in] ulFlags

Um dos sinalizadores de bits opcionais fornecidos pelo chamador que especificam filtros de pesquisa. Se nenhum sinalizador for especificado, a função fornecerá todos os identificadores de instância para todas as instâncias do dispositivo. Para obter uma lista de sinalizadores de bits, consulte a descrição ulFlags para CM_Get_Device_ID_List.

[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 obter informações sobre IDs de instância do dispositivo, consulte Cadeias de caracteres de identificação do dispositivo.

A funcionalidade para acessar computadores remotos foi removida em Windows 8 e Windows Server 2012 e sistemas operacionais 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