Applies to:
SQL Server
지정된 버전의 모든 SQL Server Express LocalDB 인스턴스를 반환합니다.
Header file:msoledbsql.h
Syntax
#define MAX_LOCALDB_INSTANCE_NAME_LENGTH 128typedef WCHAR TLocalDBInstanceName [ MAX_LOCALDB_INSTANCE_NAME_LENGTH + 1 ] ;
typedef TLocalDBInstanceName* PTLocalDBInstanceName;
HRESULT LocalDBGetInstances(
PTLocalDBInstanceName pInstanceNames ,
LPDWORD lpdwNumberOfInstances
);
Arguments
pInstanceNames
[출력] 이 함수가 반환될 때 사용자의 워크스테이션에서 명명된 LocalDB 인스턴스와 기본 LocalDB 인스턴스의 이름이 모두 포함됩니다.
lpdwNumberOfInstances
[Input/Output] On input, this option contains the number of slots for instance names in the pInstanceNames buffer. 출력 시 이 옵션에는 사용자의 워크스테이션에 있는 LocalDB 인스턴스 수가 포함됩니다.
Returns
S_OK: 함수가 성공했습니다.
| Error | Description |
|---|---|
| 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 | 예기치 않은 오류가 발생했습니다. 자세한 내용은 이벤트 로그를 참조하세요. |
Remarks
LocalDB API를 사용하는 코드 샘플은 SQL Server Express LocalDB 참조를 참조하세요.