Función DevCreateObjectQueryFromIdsEx (devquery.h)
Crea una consulta de dispositivo para recuperar propiedades basadas en los parámetros de consulta, los parámetros extendidos y una lista de identificadores de objeto especificados.
Sintaxis
HRESULT DevCreateObjectQueryFromIdsEx(
[in] DEV_OBJECT_TYPE ObjectType,
[in] PCZZWSTR pszzObjectIds,
[in] ULONG QueryFlags,
[in] ULONG cRequestedProperties,
[in, optional] const DEVPROPCOMPKEY *pRequestedProperties,
[in] ULONG cFilterExpressionCount,
[in, optional] const DEVPROP_FILTER_EXPRESSION *pFilter,
[in] ULONG cExtendedParameterCount,
[in, optional] const DEV_QUERY_PARAMETER *pExtendedParameters,
[in] PDEV_QUERY_RESULT_CALLBACK pCallback,
[in, optional] PVOID pContext,
[out] PHDEVQUERY phDevQuery
);
Parámetros
[in] ObjectType
Valor de la enumeración DEV_OBJECT_TYPE que determina el tipo de objeto en el que debe funcionar esta consulta.
[in] pszzObjectIds
Una lista de varios sz de identificadores de objeto para los objetos en los que debe funcionar la consulta. Para obtener información sobre las cadenas de varios sz, vea REG_MULTI_SZ.
[in] QueryFlags
Combinación de DEV_QUERY_FLAGS valores que se combinan mediante una operación OR bit a bit.
[in] cRequestedProperties
Número de estructuras de
[in, optional] pRequestedProperties
Opcionalmente, proporciona una matriz de estructuras de DEVPROPCOMPKEY que especifican las propiedades que se deben recuperar para los objetos del conjunto de resultados de la consulta cuando se llama a pCallback para notificar a la consulta una adición de un objeto a su conjunto de resultados.
Si se especificó DevQueryFlagUpdateResults en QueryFlags, se notificará a la consulta si el valor de cualquiera de estas propiedades cambia para cualquier objeto del conjunto de resultados de la consulta.
El campo LocaleName del estructura de DEVPROPCOMPKEY se omite y debe establecerse en NULL.
Si cRequestedProperties es 0, debe ser NULL.
[in] cFilterExpressionCount
Número de estructuras de DEVPROP_FILTER_EXPRESSION proporcionadas en pFilter.
[in, optional] pFilter
Opcionalmente, proporciona una matriz de estructuras de DEVPROP_FILTER_EXPRESSION que especifican criterios de filtro para qué objetos deben formar parte del conjunto de resultados de la consulta. Si cFilterExpressionCount es 0, debe ser NULL.
[in] cExtendedParameterCount
Reservado para el uso del sistema. Debe establecerse en 0.
[in, optional] pExtendedParameters
Reservado para el uso del sistema. Debe establecerse en NULL.
[in] pCallback
Función de devolución de llamada PDEV_QUERY_RESULT_CALLBACK a la que se deben enviar los resultados de esta consulta.
[in, optional] pContext
Contexto proporcionado por el autor de la llamada. Este valor se pasa a la función de devolución de llamada sin modificar.
[out] phDevQuery
Puntero que recibe el identificador que representa la consulta. Si se especifica DevQueryFlagsUpdateResults, la consulta recibirá actualizaciones hasta que se cierre el identificador. Llame a DevCloseObjectQuery para cerrar este identificador para detener la consulta.
Valor devuelto
S_OK se devuelve si una consulta se creó correctamente; de lo contrario, es un valor de error adecuado.
Observaciones
Para obtener un ejemplo de creación de consultas de dispositivo para recuperar propiedades basadas en los parámetros de consulta especificados y una lista de identificadores de objeto, vea DevCreateObjectQueryFromIds.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 10, versión 1809 |
| servidor mínimo admitido | Windows Server 2019 |
| encabezado de |
devquery.h |
| biblioteca de |
Onecore.lib |
| DLL de |
Cfgmgr32.dll |