Método IEventControl::SetDefaultQuery (eventsys.h)

Establece la consulta predeterminada para determinar los suscriptores.

Sintaxis

HRESULT SetDefaultQuery(
  [in]          BSTR methodName,
  [in]          BSTR criteria,
  [out, retval] int  *errorIndex
);

Parámetros

[in] methodName

Nombre del método al que se asigna la consulta predeterminada.

[in] criteria

Criterios de consulta. Este parámetro no puede ser NULL. Para obtener más información sobre cómo formar una expresión válida para este parámetro, consulte la sección Comentarios a continuación.

[out, retval] errorIndex

Ubicación, expresada como un desplazamiento, de un error en el parámetro criteria .

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Los criterios de consulta especificados por el parámetro criteria pueden ser "ALL", para especificar una solicitud para todos los objetos de suscripción o una expresión booleana que indica una o varias condiciones que un objeto de suscripción debe cumplir para incluirse en el resultado de la consulta. Las expresiones válidas tienen el formato siguiente:

[NOT] propertynamerelationalOperatorvalue. Los operadores relacionales válidos son los siguientes:

==, =, !=, <>, ~=. Los valores válidos son "string", 'string', {GUID}, TRUE, FALSE, NULL.

Las expresiones booleanas individuales se pueden combinar con AND u OR. Las expresiones se pueden anidar entre paréntesis para aplicar un orden específico de evaluación.

A continuación se muestran algunos ejemplos de criterios de consulta válidos:

"EventClassID == {F89859D1-6565-11D1-88C8-0080C7D771BF}"

"EventClassID == {F89859D1-6565-11D1-88C8-0080C7D771BF} AND MethodName = 'StockPriceChange'"

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	eventsys.h

Consulte también

IEventControl