Функция LocalDBGetInstances
Область применения: SQL Server
Возвращает все экземпляры SQL Server Express LocalDB с данной версией.
Файл заголовка: msoledbsql.h
Синтаксис
#define MAX_LOCALDB_INSTANCE_NAME_LENGTH 128typedef WCHAR TLocalDBInstanceName[MAX_LOCALDB_INSTANCE_NAME_LENGTH + 1];typedef TLocalDBInstanceName* PTLocalDBInstanceName;
HRESULT LocalDBGetInstances(
PTLocalDBInstanceName pInstanceNames,
LPDWORD lpdwNumberOfInstances
);
Параметры
pInstanceNames
[Выходные данные] Когда эта функция возвращается, содержит имена именованных и стандартных экземпляров LocalDB на рабочей станции пользователя.
lpdwNumberOfInstances
[Вход/Выход] На входе содержит число ячеек для имен экземпляров в буфере pInstanceNames . В выходных данных содержит количество экземпляров LocalDB, найденных на рабочей станции пользователя.
Возвраты
S_OK
Функция выполнена успешно.
LOCALDB_ERROR_NOT_INSTALLED
Компонент SQL Server Express LocalDB не установлен на компьютере.
LOCALDB_ERROR_INVALID_PARAMETER
Один или несколько указанных входных параметров недопустимы.
LOCALDB_ERROR_INSUFFICIENT_BUFFER
Размер входного буфера является недостаточным, а усечение не было запрошено.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
Длина пути к месту хранения экземпляра больше MAX_PATH.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY
Не удалось получить доступ к реестру экземпляра.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
Конфигурация экземпляра повреждена.
LOCALDB_ERROR_INTERNAL_ERROR
Произошла непредвиденная ошибка. Подробные сведения см. в журнале событий.
Замечания
Образец кода, использующего API LocalDB, см. в разделе SQL Server Express LocalDB Reference