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 |