Função CM_Get_Device_ID_List_Size_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_Size .]

A função CM_Get_Device_ID_List_Size_Ex recupera o tamanho do buffer necessário para manter uma lista de IDs de instância do dispositivo para instâncias de dispositivos locais ou de um computador remoto.

Sintaxe

CMAPI CONFIGRET CM_Get_Device_ID_List_Size_ExA(
  [out]          PULONG   pulLen,
  [in, optional] PCSTR    pszFilter,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parâmetros

[out] pulLen

Recebe um valor que representa o tamanho do buffer necessário, em caracteres.

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

[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á o tamanho do buffer necessário para manter 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_Ex.

[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

A função CM_Get_Device_ID_List_Size_Ex deve ser chamada para determinar o tamanho do buffer exigido pelo CM_Get_Device_ID_List_Ex.

O valor de tamanho fornecido no local apontado pelo pulLen é garantido para representar um tamanho de buffer grande o suficiente para manter todas as cadeias de caracteres de identificador de instância do dispositivo e encerrar NULLs. O valor fornecido pode realmente representar um tamanho de buffer maior do que o necessário, portanto, não suponha que o valor represente o comprimento verdadeiro das cadeias de caracteres que CM_Get_Device_ID_List_Ex fornecerá.

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

Confira também

CM_Get_Device_ID_List_Size