Функция Жетенаблемултиинстанце

Применимо к: Windows | Windows Сервером

Функция Жетенаблемултиинстанце

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

Windows xp: жетенаблемултиинстанце появился в Windows XP.

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

Параметры

псетсиспарам

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

ксетсиспарам

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

пксетсукцеед

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

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

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

Код возврата

Описание

JET_errSuccess

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

JET_errIndexTuplesInvalidLimits

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

Windows XP: это возвращаемое значение вводится в Windows XP.

JET_errInvalidPath

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

JET_errRunningInOneInstanceMode

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

JET_errSystemParamsAlreadySet

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

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

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

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

Комментарии

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

Требования

Требование Применение

Клиент

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

Server

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

Header

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

Библиотека

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

КОМПОНОВКИ

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

Юникод

Реализуется как жетенаблемултиинстанцев (Юникод) и жетенаблемултиинстанцеа (ANSI).

См. также:

JET_ERR
JET_SETSYSPARAM
жеткреатеинстанце
жетинит
жетсетсистемпараметер