función CM_Get_Device_Interface_List_SizeW (cfgmgr32.h)

  • Artículo

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_SizeW(
  [out]          PULONG      pulLen,
  [in]           LPGUID      InterfaceClassGuid,
  [in, optional] DEVINSTID_W 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 varias 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 simbólicos de vínculo para las interfaces de dispositivo compatibles con el dispositivo, para la clase especificada. Si este valor es NULL o si 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 los hay.
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 actualmente activos y que coinciden con el GUID y el identificador de instancia de dispositivo especificados, si los hay.

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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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