Applies to:
SQL Server
지정된 SQL Server Express LocalDB 인스턴스의 실행을 중지합니다.
Header file:msoledbsql.h
Syntax
HRESULT LocalDBStopInstance(
PCWSTR pInstanceName ,
DWORD dwFlags ,
ULONG ulTimeout
);
Arguments
pInstanceName
[입력] 중지할 LocalDB 인스턴스의 이름입니다.
dwFlags
[입력] 인스턴스를 중지하는 방법을 지정하는 플래그 값 중 하나 또는 조합입니다.
Available flags:
LOCALDB_SHUTDOWN_KILL_PROCESS
종료 프로세스 운영 체제 명령을 사용하여 즉시 종료합니다.
LOCALDB_SHUTDOWN_WITH_NOWAIT
옵션 Transact-SQL 명령을 사용하여 WITH NOWAIT 종료합니다.
플래그가 설정되지 않으면 Transact-SQL 명령을 사용하여 LocalDB 인스턴스가 SHUTDOWN 종료됩니다. 두 플래그가 모두 설정되면 플래그가 LOCALDB_SHUTDOWN_KILL_PROCESS 우선합니다.
ulTimeout
[입력] 이 작업이 완료되기를 기다리는 시간(초)입니다. 이 값이면 이 함수는 0LocalDB 인스턴스가 중지될 때까지 기다리지 않고 즉시 반환됩니다.
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_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 | 예기치 않은 오류가 발생했습니다. 자세한 내용은 이벤트 로그를 참조하세요. |
Remarks
LocalDB API를 사용하는 코드 샘플은 SQL Server Express LocalDB 참조를 참조하세요.