Функция 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