Функция JetGetInstanceInfo

  • Статья

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

Функция JetGetInstanceInfo

Функция JetGetInstanceInfo извлекает сведения о запущенных экземплярах.

Windows XP: JetGetInstanceInfo представлен в Windows XP.

    JET_ERR JET_API JetGetInstanceInfo(
      __out         unsigned long* pcInstanceInfo,
      __out         JET_INSTANCE_INFO** paInstanceInfo
    );

Параметры

pcInstanceInfo

Указатель на буфер, который получает количество элементов, хранящихся в paInstanceInfo.

paInstanceInfo

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

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

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

Код возврата

Описание

JET_errSuccess

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

JET_errInvalidParameter

Один из предоставленных параметров содержал непредвиденное значение или значение, которое не имело смысла в сочетании со значением другого параметра. Эта ошибка будет возвращена JetGetInstanceInfo , если:

  • pcInstanceInfo или paInstanceInfo имеют значение NULL.

JET_errOutOfMemory

Недостаточно памяти для обработки запроса.

Комментарии

Ядро СУБД выделит массив JET_INSTANCE_INFO структур. Вызывающий объект отвечает за освобождение этой памяти с помощью JetFreeBuffer.

Если активных экземпляров нет, JetGetInstanceInfo вернет JET_errSuccess, а pcInstanceInfo получит значение 0.

Требования

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

Клиент

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

Сервер

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

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

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

Библиотека

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

DLL

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

Юникод

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

См. также:

JET_ERR
JET_INSTANCE
JET_INSTANCE_INFO
JetFreeBuffer