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

Establece una consulta predeterminada que se usará cuando un filtro de publicador no está asociado a un método de evento.

Sintaxis

HRESULT SetDefaultQuery(
  [in]          REFIID eventIID,
  [in]          BSTR   bstrMethodName,
  [in]          BSTR   bstrCriteria,
  [out, retval] int    *errorIndex
);

Parámetros

[in] eventIID

Identificador de interfaz de la interfaz de activación.

[in] bstrMethodName

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

[in] bstrCriteria

Cadena que especifica los 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

La ubicación, expresada como un desplazamiento, de un error en el parámetro bstrCriteria .

Valor devuelto

Este método puede devolver los valores devueltos estándar E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED y E_FAIL, así como los siguientes valores.

Código devuelto	Descripción
S_OK	El método se completó correctamente.
EVENT_E_QUERYSYNTAX	Error de sintaxis al intentar evaluar una cadena de consulta.
EVENT_E_QUERYFIELD	Se usó un nombre de campo no válido en una cadena de consulta.
EVENT_E_INTERNALEXCEPTION	Se ha producido una excepción inesperada.
EVENT_E_INTERNALERROR	Se detectó un error interno inesperado.

Comentarios

Este método es una forma más especializada del método IEventSystem::Query . Además de obtener solo objetos de suscripción, una colección obtenida mediante una llamada a GetSubscriptions se actualiza automáticamente cada vez que cambia la colección de suscripciones.

Los criterios de consulta especificados por el parámetro bstrCriteria 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 debe cumplir un objeto de suscripción 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

IMultiInterfaceEventControl