Función DevCreateObjectQueryFromIdEx (devquery.h)

Crea una consulta de dispositivo para recuperar propiedades basadas en los parámetros de consulta, los parámetros extendidos y el identificador de objeto especificados.

Sintaxis

HRESULT DevCreateObjectQueryFromIdEx(
  [in]           DEV_OBJECT_TYPE                 ObjectType,
  [in]           PCWSTR                          pszObjectId,
  [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] pszObjectId

Identificador de cadena del objeto específico en el que debe funcionar la consulta.

[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 DEVPROPCOMPKEY proporcionadas en pRequestedProperties. Si se especifica DevQueryFlagAllProperties, debe establecerse en 0.

[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

Una 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

Cuando un cliente quiere recuperar datos sobre un objeto específico dada su identidad, use esta función en lugar de DevCreateObjectQuery con un filtro. Esta función es más eficaz.

Para obtener más información, vea la sección comentarios de DevCreateObjectQuery, que también se aplican a esta función. Para obtener un ejemplo de creación de una consulta de dispositivo para recuperar propiedades basadas en los parámetros de consulta y el identificador de objeto especificados, vea DevCreateObjectQueryFromId.

Requisitos

Consulte también

DevCreateObjectQuery