IMAPITable::Restrict

9/8/2008

The Restringir método se aplica um filtro a uma tabela, reduzindo a linha definida para somente as linhas compatível os critérios especificados.

Observação

Este método é com suporte para somente tabelas conteúdo.

Syntax

HRESULT Restrict (
  LPSRestriction lpRestriction,
  ULONG ulFlags
);

Parameters

• lpRestriction
  [no] Referência a um SRestriction estrutura, que contém membros que definem condições de filtro; não pode ser NULL.

• ulFlags
  [no] Ignorado.

Return Value

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED GPSGetPosition, e E_FAIL, as well as o seguinte.

• S_OK
  Indica sucesso.

• MAPI_E_BUSY
  Outra operação é em andamento que impede a operação de restrição seja iniciado. Ambos a operação em andamento devem ser permitidos para completo ou ela deve ser interrompida.

• MAPI_E_TOO_COMPLEX
  A tabela não é possível executar a operação porque o filtro específico apontado pelo lpRestriction parâmetro é muito complexa.

Remarks

Restringir Estabelece uma restrição, ou filtro, em uma tabela. Se houver uma restrição anterior, ele será descartado e o outro é aplicado. Não aplicar uma restrição tem nenhum efeito sobre o dados subjacentes de uma tabela; Ela simplesmente altera a exibição limitando as linhas que podem ser recuperadas às linhas que contêm dados que satisfazem a restrição.

Há vários tipos diferentes de restrições, cada descrito com uma estrutura diferente. The SRestriction estrutura contém dois membros: Um valor que indica o tipo de restrição e aplicável a estrutura específica para esse tipo. The Restringir método em Windows Mobile Mensagens requer o tipo de restrição, especificado pelo RT membro de SRestriction, seja RES_PROPERTY.

Todos os indicadores para uma tabela são descartados quando um chamar para Restringir é feita, e BOOKMARK_CURRENT, a atual posição do cursor, é definido para o início da tabela.

Se você tentar impor uma restrição propriedade em uma propriedade que não esteja na conjunto de colunas da tabela, os resultados são indefinido. Sempre que você não tiver certeza de se uma propriedade é com suporte em uma tabela, antes de tentar impor a restrição propriedade, combina a restrição propriedade com um RES_EXIST tipo de Restrição para verificar a existência de propriedade.

Não esperados receber uma notificação tabela em uma linha que foi filtrada de uma tabela devido a uma restrição.

Requirements

Header	mapidefs.h
Library	cemapi.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

IMAPITable
IMAPITable::QueryRows
SPropertyRestriction

Other Resources

Messaging