Функция LocalDBGetInstances

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

Файл заголовка: sqlncli.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.

См. также

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