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

[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 instancia de función específica.

Sintaxis

HRESULT CreateInstanceQuery(
  [in]      const WCHAR                    *pszFunctionInstanceIdentity,
  [in]      IFunctionDiscoveryNotification *pIFunctionDiscoveryNotification,
  [in, out] FDQUERYCONTEXT                 *pfdqcQueryContext,
  [out]     IFunctionInstanceQuery         **ppIFunctionInstanceQuery
);

Parámetros

[in] pszFunctionInstanceIdentity

Identificador de la instancia de función.

[in] pIFunctionDiscoveryNotification

Puntero a la interfaz IFunctionDiscoveryNotification implementada por la aplicación que realiza la llamada. Si se especifica, 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.

[in, out] pfdqcQueryContext

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

[out] ppIFunctionInstanceQuery

Puntero a un puntero de interfaz IFunctionInstanceQuery que se usa para devolver la consulta generada.

Valor devuelto

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

Código devuelto	Descripción
S_OK	El método se completó correctamente.
E_INVALIDARG	ppIFunctionInstanceQuery es NULL.
E_OUTOFMEMORY	El método no puede asignar la memoria necesaria para realizar esta operación.

Comentarios

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 IFunctionInstanceQuery devuelta en ppIFunctionInstanceQuery para realizar la consulta y devolver los datos.

Requisitos

Requisito	Value
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