Share via

Функция JetEnableMultiInstance

  • Статья

Применимо к: Windows | Windows Server

Функция JetEnableMultiInstance

Функция JetEnableMultiInstance настраивает ядро СУБД для использования с несколькими экземплярами в одном процессе. Необязательный массив глобальных системных параметров доступен первому вызывающему объекту, что позволяет переходить в режим нескольких экземпляров.

Windows XP: JetEnableMultiInstance появился в Windows XP.

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

Параметры

psetsysparam

Массив глобальных системных параметров, устанавливаемых только в том случае, если подсистема переходит в режим нескольких экземпляров в результате этого вызова. Если csetsysparam равно нулю, то psetsysparam игнорируется.

csetsysparam

Количество элементов для массива глобальных параметров, устанавливаемых только в том случае, если подсистема в результате этого вызова переходит в режим с несколькими экземплярами. Если csetsysparam равно нулю, то psetsysparam игнорируется.

pcsetsucceed

Указатель на количество глобальных системных параметров, которые были успешно настроены в результате этого вызова.

Возвращаемое значение

Эта функция возвращает тип данных JET_ERR с одним из следующих кодов возврата. Дополнительные сведения о возможных ошибках ESE см. в разделах Ошибки подсистемы расширяемого хранилища и Параметры обработки ошибок.

Код возврата

Описание

JET_errSuccess

Операция выполнена успешно.

JET_errIndexTuplesInvalidLimits

Указанные параметры индекса кортежа не были разрешены. Эта ошибка может быть возвращена JetEnableMultiInstance только при установке недопустимого значения JET_paramIndexTuplesLengthMin, JET_paramIndexTuplesLengthMax или JET_paramIndexTuplesToIndexMax .

Windows XP: Это возвращаемое значение появилось в Windows XP.

JET_errInvalidPath

Указанный путь к файловой системе недопустим. Эта ошибка может быть возвращена JetEnableMultiInstance только при задании системных параметров, представляющих пути к файловой системе. Например, JET_paramSystemPath может возвращать эту ошибку.

JET_errRunningInOneInstanceMode

Операция завершилась сбоем, так как она является недопустимой, когда ядро СУБД работает в режиме одного экземпляра (режим совместимости Windows 2000).

JET_errSystemParamsAlreadySet

Сбой JetEnableMultiInstance , так как подсистема уже находится в режиме нескольких экземпляров.

Примечание Это произойдет, даже если системные параметры не указаны.

Если эта функция будет выполнена успешно, ядро СУБД будет настроено для работы в режиме нескольких экземпляров. Подсистема также успешно настроена с необязательным списком глобальных системных параметров.

Если эта функция завершается сбоем, ядро СУБД останется в текущем режиме. Если pcsetsucceed не равно нулю, это число системных параметров останется заданным.

Комментарии

Эту функцию следует использовать только в том случае, если приложение должно настроить заданный набор системных параметров атомарно при настройке ядра СУБД для использования в многопользовательском сценарии в том же процессе. Если доступен другой метод синхронизации, предпочтительнее вызывать JetCreateInstance и JetSetSystemParameter отдельно.

Требования

Требование Значение

Клиент

Требуется Windows Vista или Windows XP.

Сервер

Требуется Windows Server 2008 или Windows Server 2003.

Верхняя часть

Объявлено в Esent.h.

Библиотека

Используйте ESENT.lib.

DLL

Требуется ESENT.dll.

Юникод

Реализовано как JetEnableMultiInstanceW (Юникод) и JetEnableMultiInstanceA (ANSI).

См. также:

JET_ERR
JET_SETSYSPARAM
JetCreateInstance
JetInit
JetSetSystemParameter