función CM_Get_Device_ID_List_Size_ExW (cfgmgr32.h)
[A partir de Windows 8 y Windows Server 2012, esta función ha quedado en desuso. Use CM_Get_Device_ID_List_Size en su lugar.
La función CM_Get_Device_ID_List_Size_Ex recupera el tamaño del búfer necesario para contener una lista de identificadores de instancia de dispositivo para las instancias de dispositivo de un equipo local o remoto.
Sintaxis
CMAPI CONFIGRET CM_Get_Device_ID_List_Size_ExW(
[out] PULONG pulLen,
[in, optional] PCWSTR pszFilter,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
Parámetros
[out] pulLen
Recibe un valor que representa el tamaño de búfer necesario, en caracteres.
[in, optional] pszFilter
Puntero proporcionado por el autor de la llamada a una cadena de caracteres que especifica un subconjunto de identificadores de instancia de dispositivo de la máquina o NULL. Consulte la siguiente descripción de ulFlags.
[in] ulFlags
Una de las marcas de bits proporcionadas por el autor de la llamada opcionales que especifican filtros de búsqueda. Si no se especifican marcas, la función proporciona el tamaño del búfer necesario para contener todos los identificadores de instancia de todas las instancias de dispositivo. Para obtener una lista de marcas de bits, consulte la descripción de ulFlags para CM_Get_Device_ID_List_Ex.
[in, optional] hMachine
Identificador de máquina proporcionado por el autor de la llamada, obtenido de una llamada anterior a CM_Connect_Machine.
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 prefijo CR_ definidos en Cfgmgr32.h.
Comentarios
Se debe llamar a la función CM_Get_Device_ID_List_Size_Ex para determinar el tamaño del búfer requerido por CM_Get_Device_ID_List_Ex.
Se garantiza que el valor de tamaño proporcionado en la ubicación a la que apunta pulLen represente un tamaño de búfer lo suficientemente grande como para contener todas las cadenas de identificador de instancia de dispositivo y terminar los VALORES NULL. El valor proporcionado podría representar realmente un tamaño de búfer mayor que el necesario, por lo que no suponga que el valor representa la longitud verdadera de las cadenas de caracteres que CM_Get_Device_ID_List_Ex proporcionará.
Para obtener información sobre los identificadores de instancia de dispositivo, consulte Cadenas de identificación de dispositivos.
La funcionalidad para acceder a las máquinas remotas se ha quitado en Windows 8 y sistemas operativos Windows Server 2012 y versiones posteriores, por lo que no se puede acceder a las máquinas remotas cuando se ejecutan en estas versiones de Windows.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Disponible en Microsoft Windows 2000 y versiones posteriores de Windows. |
Plataforma de destino | Escritorio |
Encabezado | cfgmgr32.h (incluya Cfgmgr32.h) |
Library | Cfgmgr32.lib |
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de