새 SQL Server Express LocalDB 인스턴스를 만듭니다.
헤더 파일: sqlncli.h
문법
HRESULT LocalDBCreateInstance(
PCWSTR wszVersion,
PCWSTR pInstanceName,
DWORD dwFlags
);
매개 변수
wszVersion
[입력] LocalDB 버전(예: 11.0 또는 11.0.1094.2)입니다.
pInstanceName
[입력] 만들 LocalDB 인스턴스의 이름입니다.
dwFlags
[입력] 나중에 사용할 수 있습니다. 현재는 0으로 설정해야 합니다.
반품
S_OK
함수가 성공했습니다.
LOCALDB_ERROR_NOT_INSTALLED
SQL Server Express LocalDB가 컴퓨터에 설치되어 있지 않습니다.
LOCALDB_ERROR_INVALID_PARAMETER
하나 이상의 지정된 입력 매개 변수가 잘못되었습니다.
LOCALDB_ERROR_INVALID_INSTANCE_NAME
지정한 인스턴스 이름이 잘못되었습니다.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
인스턴스를 저장해야 하는 경로가 MAX_PATH 이상입니다.
LOCALDB_ERROR_INSTANCE_EXISTS_WITH_LOWER_VERSION
지정된 인스턴스가 이미 있지만 해당 버전이 요청된 것보다 낮습니다.
LOCALDB_ERROR_UNKNOWN_VERSION
지정된 버전을 사용할 수 없습니다.
LOCALDB_ERROR_VERSION_REQUESTED_NOT_INSTALLED
지정된 패치 수준이 설치되지 않았습니다.
LOCALDB_ERROR_CANNOT_CREATE_INSTANCE_FOLDER
%userprofile%폴더를 만들 수 없습니다.
LOCALDB_ERROR_CANNOT_GET_USER_PROFILE_FOLDER
사용자 프로필 폴더를 검색할 수 없습니다.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER
인스턴스 폴더에 액세스할 수 없습니다.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY
인스턴스 레지스트리에 액세스할 수 없습니다.
LOCALDB_ERROR_CANNOT_MODIFY_INSTANCE_REGISTRY
인스턴스 레지스트리를 수정할 수 없습니다.
LOCALDB_ERROR_SQL_SERVER_STARTUP_FAILED
SQL Server 프로세스가 시작되었지만 SQL Server 시작에 실패했습니다.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
인스턴스 구성이 손상되었습니다.
LOCALDB_ERROR_INTERNAL_ERROR
예기치 않은 오류가 발생했습니다. 자세한 내용은 이벤트 로그를 참조하세요.
비고
지정된 이름을 가진 완벽하게 작동하는 LocalDB 인스턴스가 이미 있고 해당 버전이 요청된 인스턴스와 같거나 높은 경우 결과는 S_OK.
기존 인스턴스가 손상된 경우 API 메서드에 대한 후속 호출이 LocalDBCreateInstance 실패합니다. 손상된 인스턴스는 수동으로 또는 명시적으로 삭제해야 다시 사용할 수 있습니다.
LocalDB API를 사용하는 코드 샘플은 SQL Server Express LocalDB 참조를 참조하세요.