función CM_Get_Device_Interface_List_SizeA (cfgmgr32.h)

La función CM_Get_Device_Interface_List_Size recupera el tamaño del búfer que se debe pasar a la función CM_Get_Device_Interface_List .

Sintaxis

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

Puntero proporcionado por el autor de la llamada a una ubicación que recibe la longitud necesaria, en caracteres, de un búfer para contener las múltiples cadenas Unicode que devolverá CM_Get_Device_Interface_List.

[in] InterfaceClassGuid

Proporciona un GUID que identifica una clase de interfaz de dispositivo.

[in, optional] pDeviceID

Puntero proporcionado por el autor de la llamada a una cadena terminada en NULL que representa un identificador de instancia de dispositivo. Si se especifica, la función recupera la longitud de los nombres de vínculo simbólico para las interfaces de dispositivo compatibles con el dispositivo, para la clase especificada. Si este valor es NULL o apunta a una cadena de longitud cero, la función recupera la longitud de los nombres de vínculo simbólicos para todas las interfaces que pertenecen a la clase especificada.

[in] ulFlags

Contiene una de las siguientes marcas proporcionadas por el autor de la llamada:

Valor	Significado
CM_GET_DEVICE_INTERFACE_LIST_ALL_DEVICES	La función proporciona el tamaño de una lista que contiene interfaces de dispositivo asociadas a todos los dispositivos que coinciden con el GUID y el identificador de instancia de dispositivo especificados, si existe.
CM_GET_DEVICE_INTERFACE_LIST_PRESENT	La función proporciona el tamaño de una lista que contiene interfaces de dispositivo asociadas a dispositivos que están activos actualmente y que coinciden con el GUID y el identificador de instancia de dispositivo especificados, si existe.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve CR_SUCCESS. De lo contrario, devuelve uno de los códigos de error con el prefijo CR_ tal y como se define en Cfgmgr32.h.

Comentarios

Nota

El encabezado cfgmgr32.h define CM_Get_Device_Interface_List_Size como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino	Universal
Encabezado	cfgmgr32.h (incluya Cfgmgr32.h)
Library	Cfgmgr32.lib
Archivo DLL	CfgMgr32.dll

Consulte también

CM_Get_Device_Interface_List