Função JetSetTableSequential

Aplica-se a: Windows | Servidor Windows

Função JetSetTableSequential

A função JetSetTableSequential notifica o mecanismo de banco de dados de que o aplicativo está verificando todo o índice atual que contém um determinado cursor. Consequentemente, os métodos usados para acessar os dados de índice serão ajustados para tornar esse cenário o mais rápido possível.

Windows XP:JetSetTableSequential é introduzido em Windows XP.

    JET_ERR JET_API JetSetTableSequential(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          JET_GRBIT grbit
    );

Parâmetros

sesid

A sessão a ser usada para essa chamada.

Tableid

O cursor a ser usado para essa chamada.

grbit

Um grupo de bits que especificam zero ou mais das opções a seguir.

Valor	Significado
JET_bitPrereadForward	Essa opção é usada para indexar na direção à frente. Windows 7:JET_bitPrereadForward é introduzido no Windows 7.
JET_bitPrereadBackward	Essa opção é usada para indexar na direção anterior. Windows 7:JET_bitPrereadBackward é introduzido no Windows 7.

Valor de retorno

Essa função retorna o tipo de dados JET_ERR com um dos seguintes códigos de retorno. Para obter mais informações sobre os possíveis erros do ESE, consulte Erros extensíveis do mecanismo Armazenamento e parâmetros de tratamento de erros.

Código de retorno	Descrição
JET_errClientRequestToStopJetService	A operação não pode ser concluída porque toda a atividade na instância associada à sessão foi quiesced como resultado de uma chamada para JetStopService.
JET_errInstanceUnavailable	A operação não pode ser concluída porque a instância associada à sessão encontrou um erro fatal que exige que o acesso a todos os dados seja revogado para proteger a integridade desses dados. Windows XP: esse valor retornado é introduzido em Windows XP.
JET_errNotInitialized	A operação não pode ser concluída porque a instância associada à sessão ainda não foi inicializada.
JET_errRestoreInProgress	A operação não pode ser concluída porque uma operação de restauração está em andamento na instância associada à sessão.
JET_errTermInProgress	A operação não pode ser concluída porque a instância associada à sessão está sendo desligada.

Se essa função for bem-sucedida, o índice atual do cursor será otimizado para uma verificação sequencial de todo o índice. Nenhuma alteração no estado do banco de dados ocorrerá.

Se essa função falhar, nenhuma alteração na configuração do cursor ocorrerá. Nenhuma alteração no estado do banco de dados ocorrerá.

Comentários

Se o aplicativo precisar verificar com eficiência um subconjunto conhecido de um índice, uma otimização semelhante também será executada sempre que um intervalo de índice for estabelecido usando JetSetIndexRange. Essa otimização só está disponível em Windows XP e versões posteriores.

Se o aplicativo precisar verificar com eficiência um subconjunto desconhecido de um índice, nenhuma ação deverá ser executada. O mecanismo pode detectar automaticamente o comportamento de verificação e buscará dados antecipadamente. No entanto, esse comportamento não é tão agressivo.

Essa otimização tornará a verificação do índice primário eficiente e tornará eficiente a verificação apenas dos dados de entrada de índice em um índice secundário. Isso não tornará a verificação de um índice secundário ao recuperar dados de registro eficiente. Isso ocorre porque o mecanismo não executa uma leitura antecipada nos dados do registro.

Requisitos

Requisito	Valor
Cliente	Requer Windows Vista ou Windows XP.
Servidor	Requer Windows Server 2008 ou Windows Server 2003.
Cabeçalho	Declarado em Esent.h.
Biblioteca	Use ESENT.lib.
DLL	Requer ESENT.dll.

Consulte Também

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetSetIndexRange
JetStopService