Função JetSetCursorFilter

aplica-se a: Windows | do Windows Server

A função JetSetCursorFilter define uma matriz de filtros simples para a função JetMove .

A função JetSetCursorFilter foi introduzida no sistema operacional Windows 8.

Atualmente, a função JetSetCursorFilter só tem suporte em índices primários.

JET_ERR JET_API JetSetCursorFilter(
  __in          JET_SESID sesid,
  __in          JET_TABLEID tableid,
  __in_ecount(cFilters)  JET_INDEX_COLUMN* rgFilters,
  __in          DWORD cFilters,
  __in          JET_GRBIT grbit
);

Parâmetros

sesid

O contexto de sessão do banco de dados a ser usado para a chamada à API.

Tableid

O cursor a ser posicionado.

rgFilters

Os filtros de registro simples.

cFilters

O número de filtros.

grbit

Um grupo de bits que especifica zero ou mais das opções de movimentação listadas na tabela a seguir.

Value	Meaning
Nenhum	Opção predefinida.

Valor de retorno

Essa função retorna o tipo de dados JET_ERR com um dos códigos de retorno listados na tabela a seguir. Para obter mais informações sobre os possíveis erros do Mecanismo de Armazenamento Extensível (ESE), consulte erros extensíveis do mecanismo de armazenamento e parâmetros de tratamento de erros.

Código de retorno	DESCRIÇÃO
JET_errSuccess	A operação foi concluída com êxito.
JET_errFilteredMoveNotSupported	JetSetCursorFilter não funciona em índices secundários.

Requirements

Requirement	Value
Cliente	Requer o Windows 8.
Servidor	Requer o Windows Server 2012.
Header	Declarado em Esent.h.
Library	Use ESENT.lib.
de DLL	Requer ESENT.dll.

Consulte também

JetMove
JET_ERR