LocalDBStartInstance 함수
적용 대상: 
SQL Server
지정된 SQL Server Express LocalDB 인스턴스를 시작합니다.
헤더 파일: msoledbsql.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)는 선택 사항입니다. 다음 표에서는 이러한 인수를 사용하기 위한 옵션과 해당 결과를 보여 줍니다.
| Buffer | 버퍼 크기 | 이유 | 작업 |
|---|---|---|---|
| NULL | NULL | 사용자는 인스턴스를 시작하려고 하며 파이프 이름이 필요하지 않습니다. | 인스턴스를 시작합니다(파이프 반환 및 필요한 버퍼 크기 반환 없음). |
| NULL | Present | 사용자가 출력 버퍼 크기를 요청합니다. 다음 호출에서 사용자는 실제 시작을 요청할 수 있습니다. | 필요한 버퍼 크기를 반환합니다(시작 없음, 파이프 반환 없음). 결과는 S_OK. |
| Present | NULL | 허용되지 않습니다. 입력이 잘못되었습니다. | 반환된 결과가 LOCALDB_ERROR_INVALID_PARAMETER. |
| Present | Present | 사용자가 인스턴스를 시작하려고 하며 인스턴스가 시작된 후 인스턴스에 연결하기 위해 파이프 이름이 필요합니다. | 버퍼 크기를 검사하고, 인스턴스를 시작하며 버퍼의 파이프 이름을 반환합니다. 버퍼 크기 인수는 종료 null을 포함하지 않고 "server=" 문자열의 길이를 반환합니다. |
LocalDB API를 사용하는 코드 샘플은 SQL Server Express LocalDB Reference를 참조하십시오.