Função JetEnableMultiInstance

Aplica-se a: Windows | Windows Server

Função JetEnableMultiInstance

A função JetEnableMultiInstance configura o mecanismo de banco de dados para uso com várias instâncias no mesmo processo. Uma matriz opcional de parâmetros do sistema global está disponível para o primeiro chamador, permitindo a alteração para o modo de várias instâncias.

Windows XP: JetEnableMultiInstance é introduzido no Windows XP.

    JET_ERR JET_API JetEnableMultiInstance(
      __in_opt      JET_SETSYSPARAM* psetsysparam,
      __in_opt      unsigned long csetsysparam,
      __out_opt     unsigned long* pcsetsucceed
    );

Parâmetros

psetsysparam

Uma matriz de parâmetros globais do sistema para definir se e somente se o mecanismo entrar no modo de várias instâncias como resultado dessa chamada. Se csetsysparam for zero, psetsysparam será ignorado.

csetsysparam

A contagem de elementos para a matriz de parâmetros globais a ser definida se e somente se o mecanismo entrar no modo de várias instâncias como resultado dessa chamada. Se csetsysparam for zero, psetsysparam será ignorado.

pcsetsucceed

Um ponteiro para a contagem de parâmetros globais do sistema que foram configurados com êxito como resultado dessa chamada.

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.

Código de retorno	Descrição
JET_errSuccess	A operação foi concluída com sucesso.
JET_errIndexTuplesInvalidLimits	Os parâmetros de índice de tupla especificados não eram permitidos. Esse erro só pode ser retornado por JetEnableMultiInstance ao definir JET_paramIndexTuplesLengthMin, JET_paramIndexTuplesLengthMax ou JET_paramIndexTuplesToIndexMax para um valor inválido. Windows XP: Esse valor retornado é introduzido no Windows XP.
JET_errInvalidPath	O caminho do sistema de arquivos especificado era inválido. Esse erro pode ser retornado por JetEnableMultiInstance somente ao definir parâmetros do sistema que representam caminhos do sistema de arquivos. Por exemplo, JET_paramSystemPath pode retornar esse erro.
JET_errRunningInOneInstanceMode	A operação falhou porque é ilegal quando o mecanismo de banco de dados está operando no modo de instância única (modo de compatibilidade do Windows 2000).
JET_errSystemParamsAlreadySet	O JetEnableMultiInstance falhou porque o mecanismo já está no modo de várias instâncias. Nota Isso acontecerá mesmo se nenhum parâmetro do sistema for especificado.

Se essa função for bem-sucedida, o mecanismo de banco de dados será configurado para ser executado no modo de várias instâncias. O mecanismo também foi configurado com êxito com a lista opcional de parâmetros do sistema global.

Se essa função falhar, o mecanismo de banco de dados permanecerá no modo atual. Se pcsetsucceed não for zero, esse número de parâmetros do sistema permanecerá definido.

Comentários

Essa função só deverá ser usada se o aplicativo precisar configurar um determinado conjunto de parâmetros do sistema atomicamente ao configurar o mecanismo de banco de dados para uso em um cenário de vários usuários no mesmo processo. Se outro método de sincronização estiver disponível, é preferível chamar JetCreateInstance e JetSetSystemParameter separadamente.

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.
Unicode	Implementado como JetEnableMultiInstanceW (Unicode) e JetEnableMultiInstanceA (ANSI).

Consulte Também

JET_ERR
JET_SETSYSPARAM
JetCreateInstance
JetInit
JetSetSystemParameter