다음을 통해 공유

LocalDBStartInstance function

Applies to:SQL Server

지정된 SQL Server Express LocalDB 인스턴스를 시작합니다.

Header file:msoledbsql.h

Syntax

HRESULT LocalDBStartInstance(
           PCWSTR pInstanceName ,
           DWORD dwFlags ,
           LPWSTR wszSqlConnection ,
           LPDWORD lpcchSqlConnection
);

Arguments

pInstanceName

[입력] 시작할 LocalDB 인스턴스의 이름입니다.

dwFlags

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

wszSqlConnection

[출력] LocalDB 인스턴스에 연결 문자열 저장할 버퍼입니다.

lpcchSqlConnection

[Input/Output] On input contains the size of the wszSqlConnection buffer in characters, including any trailing nulls. 출력에서 지정된 버퍼 크기가 너무 작은 경우 후행 null을 포함하여 필요한 버퍼 크기를 문자로 포함합니다.

Returns

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

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

Details

Both the connection buffer argument (wszSqlConnection) and the connection buffer size argument (lpcchSqlConnection) are optional. 다음 표에서는 이러한 인수를 사용하기 위한 옵션과 해당 결과를 보여 줍니다.

Buffer Buffer size Rationale Action
NULL NULL 사용자는 인스턴스를 시작하려고 하며 파이프 이름이 필요하지 않습니다. 인스턴스를 시작합니다(파이프 반환 및 필요한 버퍼 크기 반환 없음).
NULL Present 사용자가 출력 버퍼 크기를 요청합니다. 다음 호출에서 사용자는 실제 시작을 요청할 수 있습니다. 필요한 버퍼 크기를 반환합니다(시작 없음, 파이프 반환 없음). 결과는 .입니다 S_OK.
Present NULL 허용되지 않습니다. 입력이 잘못되었습니다. 반환된 결과는 .입니다 LOCALDB_ERROR_INVALID_PARAMETER.
Present Present 사용자는 인스턴스를 시작하려고 하며 시작된 후 연결하려면 파이프 이름이 필요합니다. 버퍼 크기를 검사하고, 인스턴스를 시작하며 버퍼의 파이프 이름을 반환합니다.
버퍼 크기 인수는 종료 null을 포함하지 않고 "server=" 문자열의 길이를 반환합니다.

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

Related content

  • Last updated on