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 인스턴스와 기본 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 Reference를 참조하십시오.