função CM_Get_Device_Interface_List_SizeA (cfgmgr32.h)

A função CM_Get_Device_Interface_List_Size recupera o tamanho do buffer que deve ser passado para a função CM_Get_Device_Interface_List .

Sintaxe

CMAPI CONFIGRET CM_Get_Device_Interface_List_SizeA(
  [out]          PULONG      pulLen,
  [in]           LPGUID      InterfaceClassGuid,
  [in, optional] DEVINSTID_A pDeviceID,
  [in]           ULONG       ulFlags
);

Parâmetros

[out] pulLen

Ponteiro fornecido pelo chamador para um local que recebe o comprimento necessário, em caracteres, de um buffer para manter as várias cadeias de caracteres Unicode que serão retornadas por CM_Get_Device_Interface_List.

[in] InterfaceClassGuid

Fornece um GUID que identifica uma classe de interface do dispositivo.

[in, optional] pDeviceID

Ponteiro fornecido pelo chamador para uma cadeia de caracteres terminada em NULL que representa uma ID de instância do dispositivo. Se especificada, a função recuperará o comprimento de nomes de link simbólicos para as interfaces de dispositivo compatíveis com o dispositivo para a classe especificada. Se esse valor for NULL ou se ele apontar para uma cadeia de caracteres de comprimento zero, a função recuperará o comprimento de nomes de link simbólicos para todas as interfaces que pertencem à classe especificada.

[in] ulFlags

Contém um dos seguintes sinalizadores fornecidos pelo chamador:

Valor	Significado
CM_GET_DEVICE_INTERFACE_LIST_ALL_DEVICES	A função fornece o tamanho de uma lista que contém interfaces de dispositivo associadas a todos os dispositivos que correspondem ao GUID especificado e à ID da instância do dispositivo, se houver.
CM_GET_DEVICE_INTERFACE_LIST_PRESENT	A função fornece o tamanho de uma lista que contém interfaces de dispositivo associadas a dispositivos que estão ativos no momento e que correspondem à ID da instância do dispositivo e GUID especificada, se houver.

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 com o prefixo CR_ , conforme definido em Cfgmgr32.h.

Comentários

Observação

O cabeçalho cfgmgr32.h define CM_Get_Device_Interface_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_Interface_List