Método IFunctionDiscovery::CreateInstanceCollectionQuery (functiondiscoveryapi.h)

[La detección de funciones está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

Crea una consulta para una colección de instancias de función específicas.

Sintaxis

HRESULT CreateInstanceCollectionQuery(
  [in]      const WCHAR                      *pszCategory,
  [in]      const WCHAR                      *pszSubCategory,
  [in]      BOOL                             fIncludeAllSubCategories,
  [in]      IFunctionDiscoveryNotification   *pIFunctionDiscoveryNotification,
  [in, out] FDQUERYCONTEXT                   *pfdqcQueryContext,
  [out]     IFunctionInstanceCollectionQuery **ppIFunctionInstanceCollectionQuery
);

Parámetros

[in] pszCategory

Categoría de la consulta. Consulte Definiciones de categorías.

[in] pszSubCategory

Subcategoría de la consulta. Consulte Subcategory Definitions (Definiciones de subcategoría). Este parámetro puede ser NULL.

Las consultas de subcategoría solo se admiten para categorías superpuestas y algunas categorías de proveedor. El proveedor del Registro, el proveedor de asociación PnP-X y las consultas de subcategoría del proveedor de publicaciones. Los proveedores personalizados se pueden diseñar explícitamente para admitir consultas de subcategoría. Esto significa que el parámetro pszSubCategory debe establecerse en un valor distinto de NULL solo cuando el parámetro pszCategory está establecido en FCTN_CATEGORY_REGISTRY, FCTN_CATEGORY_PUBLICATION, FCTN_CATEGORY_PNPXASSOCIATION o un valor de categoría personalizado definido para una categoría superpuesta o un proveedor personalizado que admita consultas de subcategoría.

[in] fIncludeAllSubCategories

Si es TRUE, este método crea de forma recursiva una consulta para todas las subcategorías de la categoría especificada en pszCategory, devolviendo una colección que contiene instancias de función de todas las subcategorías de pszCategory.

Si es FALSE, este método restringe la consulta creada para devolver instancias de función en la categoría especificada por pszCategory y la subcategoría especificada por pszSubCategory.

[in] pIFunctionDiscoveryNotification

Puntero a la interfaz IFunctionDiscoveryNotification implementada por la aplicación que realiza la llamada. Este parámetro puede ser NULL. Este puntero es válido hasta que se libera el objeto de consulta devuelto.

[in, out] pfdqcQueryContext

Puntero al contexto en el que se creó la consulta. El tipo FDQUERYCONTEXT se define como DWORDLONG.

[out] ppIFunctionInstanceCollectionQuery

Puntero al puntero de interfaz IFunctionInstanceCollectionQuery .

Valor devuelto

Entre los valores devueltos posibles se incluyen, entre otros, los siguientes.

Código o valor devuelto	Descripción
S_OK	El método se completó correctamente.
E_INVALIDARG	El valor de pszCategory o pIID no es válido. El valor devuelto en el parámetro ppIFunctionInstanceCollectionQuery es NULL.
E_OUTOFMEMORY	El método no puede asignar la memoria necesaria para realizar esta operación.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) 0x80070002	El valor de pszCategory o pszSubCategory es desconocido.

Comentarios

Si se especifica pIFunctionDiscoveryNotification , habilita el proceso de notificación de cambio de detección de funciones. Este parámetro puede ser NULL. Sin embargo, es necesario para los proveedores de red, ya que no devuelven resultados sincrónicos. Los proveedores de red de detección de funciones solo devuelven instancias a través de la interfaz IFunctionDiscoveryNotification .

Este método solo inicializa la llamada de consulta. Se debe llamar al método Execute de la interfaz IFunctionInstanceCollectionQuery devuelta en ppIFunctionInstanceCollectionQuery para realizar la consulta y devolver los datos.

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	functiondiscoveryapi.h
Archivo DLL	FunDisc.dll

Consulte también

Consultas de detección de funciones

IFunctionDiscovery