Функция 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 , если:
|
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). |