LocalDBStartInstance 함수
지정한 SQL Server Express LocalDB 인스턴스를 시작합니다.
헤더 파일: sqlncli.h
구문
HRESULT LocalDBStartInstance(
PCWSTR pInstanceName,
DWORD dwFlags,
LPWSTR wszSqlConnection,
LPDWORD lpcchSqlConnection
);
매개 변수
pInstanceName
[입력] 시작할 LocalDB 인스턴스의 이름입니다.dwFlags
[입력] 나중에 사용하도록 예약되어 있습니다. 현재 0으로 설정해야 합니다.wszSqlConnection
[출력] LocalDB 인스턴스에 연결 문자열을 저장할 버퍼입니다.lpcchSqlConnection
[입력/출력] 출력 시 후행 Null을 포함하여 문자의 wszSqlConnection 버퍼 크기를 포함합니다. 출력 시 지정된 버퍼 크기가 너무 작은 경우 후행 Null을 포함하여 문자에 필요한 버퍼 크기를 포함합니다.
반환 값
S_OK
함수가 성공했습니다.LOCALDB_ERROR_NOT_INSTALLED
SQL Server Express LocalDB가 컴퓨터에 설치되어 있지 않습니다.LOCALDB_ERROR_INVALID_PARAMETER
지정한 입력 매개 변수 중 한 개 이상이 잘못되었습니다.LOCALDB_ERROR_INVALID_INSTANCE_NAME
지정한 인스턴스 이름이 잘못되었습니다.LOCALDB_ERROR_UNKNOWN_INSTANCE
인스턴스가 없습니다.LOCALDB_ERROR_INSUFFICIENT_BUFFER
지정한 버퍼 wszSqlConnection이 너무 작습니다.LOCALDB_ERROR_WAIT_TIMEOUT
동기화 잠금을 획득하려고 시도하는 동안 제한 시간이 발생했습니다.LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
인스턴스를 저장할 경로가 MAX_PATH보다 깁니다.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_CANNOT_CREATE_SQL_PROCESS
SQL Server에 대한 프로세스를 만들 수 없습니다.LOCALDB_ERROR_SQL_SERVER_STARTUP_FAILED
SQL Server 프로세스가 시작되었지만 SQL Server 시작이 실패했습니다.LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
인스턴스 구성이 손상되었습니다.LOCALDB_ERROR_AUTO_INSTANCE_CREATE_FAILED
자동 인스턴스를 만들 수 없습니다. 자세한 오류 정보는 Windows 응용 프로그램 이벤트 로그를 참조하십시오.LOCALDB_ERROR_INTERNAL_ERROR
예기치 않은 오류가 발생했습니다. 자세한 내용은 이벤트 로그를 참조하십시오.
자세한 정보
연결 버퍼 인수(wszSqlConnection) 및 연결 버퍼 크기 인수(lpcchSqlConnection)는 선택 사항입니다. 다음 표에서는 이러한 인수를 사용하기 위한 옵션과 해당 결과를 보여 줍니다.
버퍼 |
버퍼 크기 |
이유 |
동작 |
|---|---|---|---|
NULL |
NULL |
사용자가 인스턴스를 시작하려고 하지만 파이프 이름은 필요하지 않습니다. |
인스턴스를 시작합니다(파이프 반환 없음, 필요한 버퍼 크기 반환 없음). |
NULL |
있음 |
사용자가 출력 버퍼 크기를 요청합니다. 다음 호출에서 사용자는 실제 시작을 요청할 수 있습니다. |
필요한 버퍼 크기를 반환합니다(시작 없음, 파이프 반환 없음). 결과는 S_OK입니다. |
있음 |
NULL |
허용되지 않으며 잘못된 입력입니다. |
반환된 결과는 LOCALDB_ERROR_INVALID_PARAMETER입니다. |
있음 |
있음 |
사용자가 인스턴스를 시작하려고 하며 인스턴스가 시작된 후 인스턴스에 연결하기 위해 파이프 이름이 필요합니다. |
버퍼 크기를 검사하고, 인스턴스를 시작하며 버퍼의 파이프 이름을 반환합니다. 버퍼 크기 인수는 종료 Null을 포함하지 않은 “server=” 문자열을 반환합니다. |
LocalDB API를 사용하는 코드 샘플은 SQL Server Express LocalDB 참조를 참조하십시오.