다음을 통해 공유


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을 포함하여 문자에 필요한 버퍼 크기를 포함합니다.

반환 값

자세한 정보

연결 버퍼 인수(wszSqlConnection) 및 연결 버퍼 크기 인수(lpcchSqlConnection)는 선택 사항입니다. 다음 표에서는 이러한 인수를 사용하기 위한 옵션과 해당 결과를 보여 줍니다.

버퍼

버퍼 크기

이유

동작

NULL

NULL

사용자가 인스턴스를 시작하려고 하지만 파이프 이름은 필요하지 않습니다.

인스턴스를 시작합니다(파이프 반환 없음, 필요한 버퍼 크기 반환 없음).

NULL

있음

사용자가 출력 버퍼 크기를 요청합니다. 다음 호출에서 사용자는 실제 시작을 요청할 수 있습니다.

필요한 버퍼 크기를 반환합니다(시작 없음, 파이프 반환 없음). 결과는 S_OK입니다.

있음

NULL

허용되지 않으며 잘못된 입력입니다.

반환된 결과는 LOCALDB_ERROR_INVALID_PARAMETER입니다.

있음

있음

사용자가 인스턴스를 시작하려고 하며 인스턴스가 시작된 후 인스턴스에 연결하기 위해 파이프 이름이 필요합니다.

버퍼 크기를 검사하고, 인스턴스를 시작하며 버퍼의 파이프 이름을 반환합니다. 버퍼 크기 인수는 종료 Null을 포함하지 않은 “server=” 문자열을 반환합니다.

LocalDB API를 사용하는 코드 샘플은 SQL Server Express LocalDB 참조를 참조하십시오.

참고 항목

개념

SQL Server Express LocalDB 헤더 및 버전 정보