Função CM_Get_Device_ID_List_SizeA (cfgmgr32.h)
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_SizeA(
[out] PULONG pulLen,
[in, optional] PCSTR 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 |