Função DevCreateObjectQueryFromIdsEx (devquery.h)

Artigo
11/15/2024

Cria uma consulta de dispositivo para recuperar propriedades com base nos parâmetros de consulta especificados, parâmetros estendidos e uma lista de IDs de objeto.

Sintaxe

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

Um valor da enumeração DEV_OBJECT_TYPE que determina o tipo de objeto no qual essa consulta deve operar.

[in] pszzObjectIds

Uma lista de vários sz de identificadores de objeto para objetos em que a consulta deve operar. Para obter informações sobre cadeias de caracteres de vários sz, consulte REG_MULTI_SZ.

[in] QueryFlags

Uma combinação de valores DEV_QUERY_FLAGS combinados usando uma operação OR bit a bit.

[in] cRequestedProperties

O número de estruturas de DEVPROPCOMPKEY fornecidas em pRequestedProperties. Se DevQueryFlagAllProperties for especificado, isso deverá ser definido como 0.

[in, optional] pRequestedProperties

Opcionalmente, fornece uma matriz de estruturas de DEVPROPCOMPKEY que especificam as propriedades que devem ser recuperadas para objetos no conjunto de resultados da consulta quando pCallback é chamado para notificar a consulta de uma adição de um objeto ao conjunto de resultados.
Se DevQueryFlagUpdateResults tiver sido especificado noQueryFlags, a consulta será notificada se o valor de qualquer uma dessas propriedades for alterado para qualquer objeto no conjunto de resultados da consulta.

O campo LocaleName da estrutura de DEVPROPCOMPKEY é ignorado e deve ser definido como NULL.

Se cRequestedProperties for 0, isso deverá ser NULL.

[in] cFilterExpressionCount

O número de estruturas de DEVPROP_FILTER_EXPRESSION fornecidas nopFilter .

[in, optional] pFilter

Opcionalmente, fornece uma matriz de estruturas de DEVPROP_FILTER_EXPRESSION que especificam critérios de filtro para quais objetos devem fazer parte do conjunto de resultados da consulta. Se cFilterExpressionCount for 0, isso deverá ser NULL.

[in] cExtendedParameterCount

Reservado para uso do sistema. Deve ser definido como 0.

[in, optional] pExtendedParameters

Reservado para uso do sistema. Deve ser definido como NULL.

[in] pCallback

Uma função de retorno de chamada PDEV_QUERY_RESULT_CALLBACK para a qual os resultados dessa consulta devem ser enviados para

[in, optional] pContext

Contexto fornecido pelo chamador. Esse valor é passado para a função de retorno de chamada sem modificação.

[out] phDevQuery

Ponteiro que recebe o identificador que representa a consulta. Se DevQueryFlagsUpdateResults for especificado, a consulta receberá atualizações até que o identificador seja fechado. Chame DevCloseObjectQuery para fechar esse identificador para interromper a consulta.

Valor de retorno

S_OK será retornado se uma consulta tiver sido criada com êxito; caso contrário, um valor de erro apropriado.

Observações

Para obter um exemplo de criação de consulta de dispositivo para recuperar propriedades com base nos parâmetros de consulta especificados e em uma lista de IDs de objeto, consulte DevCreateObjectQueryFromIds.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10 versão 1809
servidor com suporte mínimo	Windows Server 2019
cabeçalho	devquery.h
biblioteca	Onecore.lib
de DLL	Cfgmgr32.dll

Consulte também

DevCreateObjectQuery

Compartilhar via