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

참고 항목

개념

SQL Server Express LocalDB 헤더 및 버전 정보