LocalDBStopInstance 함수
적용 대상: 
SQL Server
지정된 SQL Server Express LocalDB 인스턴스의 실행을 중지합니다.
헤더 파일: msoledbsql.h
구문
HRESULT LocalDBStopInstance(
PCWSTR pInstanceName,
DWORD dwFlags,
ULONG ulTimeout
);
매개 변수
pInstanceName
[입력] 중지할 LocalDB 인스턴스의 이름입니다.
dwFlags
[입력] 인스턴스를 중지하는 방법을 지정하는 플래그 값 중 하나 또는 조합입니다.
사용 가능한 플래그:
LOCALDB_SHUTDOWN_KILL_PROCESS
종료 프로세스 운영 체제 명령을 사용하여 즉시 종료합니다.
LOCALDB_SHUTDOWN_WITH_NOWAIT
WITH NOWAIT 옵션 Transact-SQL 명령을 사용하여 종료합니다.
플래그가 설정되지 않은 경우 SHUTDOWN Transact-SQL 명령을 사용하여 LocalDB 인스턴스가 종료됩니다. 두 플래그가 모두 설정되면 LOCALDB_SHUTDOWN_KILL_PROCESS 플래그가 우선합니다.
ulTimeout
[입력] 이 작업이 완료되기를 기다리는 시간(초)입니다. 이 값이 0이면 LocalDB 인스턴스가 중지될 때까지 기다리지 않고 이 함수가 즉시 반환됩니다.
반품
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_WAIT_TIMEOUT
동기화 잠금을 획득하는 동안 시간 초과가 발생했습니다.
LOCALDB_ERROR_INSTANCE_STOP_FAILED
지정된 시간 내에 중지 작업을 완료하지 못했습니다.
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_INSTANCE_CONFIGURATION_CORRUPT
인스턴스 구성이 손상되었습니다.
LOCALDB_ERROR_CALLER_IS_NOT_OWNER
API 호출자는 LocalDB 인스턴스 소유자가 아닙니다.
LOCALDB_ERROR_INTERNAL_ERROR
예기치 않은 오류가 발생했습니다. 자세한 내용은 이벤트 로그를 참조하세요.
설명
LocalDB API를 사용하는 코드 샘플은 SQL Server Express LocalDB Reference를 참조하십시오.