지정된 버전의 모든 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
예기치 않은 오류가 발생했습니다. 자세한 내용은 이벤트 로그를 참조하십시오.
주의
LocalDB API를 사용하는 코드 샘플은 SQL Server Express LocalDB 참조를 참조하십시오.