Функция LocalDBGetInstances

Возвращает все экземпляры SQL Server Express LocalDB с данной версией.

Файл заголовка: sqlncli.h

Синтаксис

#define MAX_LOCALDB_INSTANCE_NAME_LENGTH 128
typedef WCHAR TLocalDBInstanceName[MAX_LOCALDB_INSTANCE_NAME_LENGTH + 1];
typedef TLocalDBInstanceName* PTLocalDBInstanceName;

HRESULT LocalDBGetInstances(
           PTLocalDBInstanceName pInstanceNames,
           LPDWORD lpdwNumberOfInstances
);

Параметры

• pInstanceNames
  [Выход] Функция возвращает значения именованных экземпляров LocalDB и экземпляров 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

См. также

Основные понятия

Заголовок и сведения о версии SQL Server Express LocalDB