Função CM_Get_Device_ID_List_SizeW (cfgmgr32.h)

  • Artigo

A função CM_Get_Device_ID_List_Size recupera o tamanho do buffer necessário para manter uma lista de IDs de instância do dispositivo para as instâncias de dispositivo do computador local.

Sintaxe

CMAPI CONFIGRET CM_Get_Device_ID_List_SizeW(
  [out]          PULONG pulLen,
  [in, optional] PCWSTR pszFilter,
  [in]           ULONG  ulFlags
);

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.

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 deve ser chamada para determinar o tamanho do buffer exigido pelo CM_Get_Device_ID_List.

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 fornecerá.

Para obter informações sobre IDs de instância do dispositivo, consulte Cadeias de caracteres de identificação do dispositivo.

Observação

O cabeçalho cfgmgr32.h define CM_Get_Device_ID_List_Size como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Microsoft Windows 2000 e versões posteriores do Windows.
Plataforma de Destino Universal
Cabeçalho cfgmgr32.h (inclua Cfgmgr32.h)
Biblioteca Cfgmgr32.lib
DLL CfgMgr32.dll

Confira também

CM_Get_Device_ID_List_Size_Ex