다음을 통해 공유


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를 참조하십시오.

참고 항목

SQL Server Express LocalDB 헤더 및 버전 정보