Compartilhar via


Função JetInit2

Aplica-se a: Windows | Windows Server

Função JetInit2

A função JetInit2 coloca o mecanismo de banco de dados em um estado em que ele pode dar suporte ao uso de aplicativos de arquivos de banco de dados. O mecanismo já deve estar configurado corretamente para inicialização usando JetSetSystemParameter. A recuperação de falha do banco de dados é executada automaticamente como parte do processo de inicialização.

O Windows XP:JetInit2 é introduzido no Windows XP.

Essa função está obsoleta. Em vez disso, use JetInit3 .

JET_ERR JET_API JetInit2(
  __in_out_opt  JET_INSTANCE* pinstance,
  __in          JET_GRBIT grbit
);

Parâmetros

pinstance

A instância a ser usada para essa chamada.

Para o Windows 2000, esse parâmetro é ignorado e sempre deve ser NULL.

Para o Windows XP e versões posteriores, o uso desse parâmetro depende do modo operacional do mecanismo. Se o mecanismo estiver operando no modo herdado (modo de compatibilidade do Windows 2000) em que apenas uma instância tem suporte, esse parâmetro pode ser NULL ou pode ser definido como um buffer de saída válido contendo NULL ou JET_instanceNil que retorna o identificador de instância global criado como um efeito colateral da inicialização. Esse identificador de instância pode ser passado para qualquer outra API que usa uma instância. Se o mecanismo estiver operando no modo de várias instâncias, esse parâmetro deverá ser definido como um buffer de entrada válido que contenha o identificador de instância retornado pelo JetCreateInstance que está sendo inicializado.

grbit

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

Valor

Significado

JET_bitReplayReplicatedLogFiles

Reservado para uso futuro.

JET_bitCreateSFSVolumeIfNotExist

Reservado para uso futuro.

JET_bitReplayIgnoreMissingDB

Essa opção permite que o usuário execute a recuperação em um conjunto de arquivos de log, sem que todos os bancos de dados estejam presentes, que foram anexados em um ponto do conjunto de logs.

JET_bitRecoveryWithoutUndo

Execute a recuperação, mas pare na fase Desfazer. Isso permite que logs de transações adicionais sejam copiados e aplicados.

JET_bitTruncateLogsAfterRecovery

Em recuperação reversível bem-sucedida, trunque arquivos de log.

JET_bitReplayMissingMapEntryDB

Entrada de mapa de banco de dados ausente padrão para o mesmo local.

JET_bitReplayIgnoreLostLogs

Ignore os logs perdidos do final do fluxo de log.

O Windows 7:JET_bitReplayIgnoreLostLogs é introduzido no Windows 7.

Valor Retornado

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 de armazenamento e parâmetros de tratamento de erros.

Comentários

Uma instância deve ser inicializada com uma chamada para JetInit2 antes de ser usada por qualquer outra coisa que não seja JetSetSystemParameter.

Uma instância é destruída por uma chamada para a função JetTerm , mesmo que essa instância nunca tenha sido inicializada usando JetInit. Uma instância é a unidade de capacidade de recuperação para o mecanismo de banco de dados. Ele controla o ciclo de vida de todos os arquivos usados para proteger a integridade dos dados em um conjunto de arquivos de banco de dados. Esses arquivos incluem o arquivo de ponto de verificação e os arquivos de log de transações.

Se a recuperação estiver em execução em um conjunto de logs, para o qual nem todos os bancos de dados estão presentes (o que retornará o erro JET_errAttachedDatabaseMismatch em circunstâncias normais) e o cliente desejará que a recuperação continue apesar dos bancos de dados ausentes, o JET_ bitReplayIgnoreMissingDB será usado para continuar a recuperação para os bancos de dados disponíveis.

Consulte a seção Comentários no JetInit para obter mais informações.

Requisitos

Requisito Valor

Cliente

Requer o Windows Vista ou o Windows XP.

Servidor

Requer o Windows Server 2008 ou o Windows Server 2003.

Cabeçalho

Declarado em Esent.h.

Biblioteca

Use ESENT.lib.

DLL

Requer ESENT.dll.

Consulte Também

Arquivos extensíveis do mecanismo de armazenamento
JET_ERR
JET_GRBIT
JET_INSTANCE
JetCreateInstance
JetInit
JetInit3
JetSetSystemParameter
Parâmetros do recurso