다음을 통해 공유

LocalDBCreateInstance function

Applies to:SQL Server

새 SQL Server Express LocalDB 인스턴스를 만듭니다.

Header file:msoledbsql.h

Syntax

HRESULT LocalDBCreateInstance(
           PCWSTR wszVersion ,
           PCWSTR pInstanceName ,
           DWORD dwFlags
);

Arguments

wszVersion

[입력] LocalDB 버전(예: 11.0 또는 11.0.1094.2)입니다.

pInstanceName

[입력] 만들 LocalDB 인스턴스의 이름입니다.

dwFlags

[입력] 나중에 사용할 수 있습니다. 현재는 0으로 설정해야 합니다.

Returns

S_OK: 함수가 성공했습니다.

Error Description
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 예기치 않은 오류가 발생했습니다. 자세한 내용은 이벤트 로그를 참조하세요.

Remarks

지정된 이름을 가진 완벽하게 작동하는 LocalDB 인스턴스가 이미 있고 해당 버전이 요청된 인스턴스보다 크거나 같은 경우 결과는 다음과 같습니다 S_OK.

기존 인스턴스가 손상된 경우 API 메서드에 대한 후속 호출이 LocalDBCreateInstance 실패합니다. 손상된 인스턴스를 다시 사용하려면 수동으로 수정하거나 명시적으로 삭제해야 합니다.

LocalDB API를 사용하는 코드 샘플은 SQL Server Express LocalDB 참조를 참조하세요.

Related content

  • Last updated on