Método IEventControl::SetDefaultQuery (eventsys.h)
Define a consulta padrão para determinar os assinantes.
Sintaxe
HRESULT SetDefaultQuery(
[in] BSTR methodName,
[in] BSTR criteria,
[out, retval] int *errorIndex
);
Parâmetros
[in] methodName
O nome do método ao qual a consulta padrão é atribuída.
[in] criteria
Os critérios de consulta. Esse parâmetro não pode ser NULL. Para obter detalhes sobre como formar uma expressão válida para esse parâmetro, consulte a seção Comentários abaixo.
[out, retval] errorIndex
O local, expresso como um deslocamento, de um erro no parâmetro criteria .
Retornar valor
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Os critérios de consulta especificados pelo parâmetro criteria podem ser "ALL", para especificar uma solicitação para todos os objetos de assinatura ou uma expressão booliana que indica uma ou mais condições que um objeto de assinatura deve atender para ser incluída no resultado da consulta. Expressões válidas são do seguinte formulário:
[NOT] propertynamerelationalOperatorvalue. Os operadores relacionais válidos são os seguintes:
==, =, !=, <>, ~=. Os valores válidos são "string", 'string', {GUID}, TRUE, FALSE, NULL.
Expressões boolianas individuais podem ser unidas com AND ou OR. As expressões podem ser aninhadas entre parênteses para impor uma ordem de avaliação específica.
A seguir estão alguns exemplos de critérios de consulta válidos:
"EventClassID == {F89859D1-6565-11D1-88C8-0080C7D771BF}"
"EventClassID == {F89859D1-6565-11D1-88C8-0080C7D771BF} AND MethodName = 'StockPriceChange'"
Requisitos
Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | eventsys.h |