Función LocalDBStopInstance

Detiene la ejecución de la instancia de SQL Server Express LocalDB especificada.

Archivo de encabezado: sqlncli.h

Sintaxis

HRESULT LocalDBStopInstance(  
           PCWSTR pInstanceName,  
           DWORD dwFlags,   
           ULONG ulTimeout   
);  

Parámetros

pInstanceName
[Entrada] Nombre de la instancia de LocalDB que se va a detener.

dwFlags
[Entrada] Una o una combinación de los valores de marca que especifican la manera de detener la instancia.

Marcas disponibles:

LOCALDB_SHUTDOWN_KILL_PROCESS
Apague inmediatamente mediante el comando de sistema operativo kill process.

LOCALDB_SHUTDOWN_WITH_NOWAIT
Apague con la opción WITH NOWAIT Transact-SQL comando.

Si no se establece ninguna de las marcas, la instancia de LocalDB se apagará mediante el comando SHUTDOWN Transact-SQL. Si se establecen ambas marcas, la marca LOCALDB_SHUTDOWN_KILL_PROCESS tiene prioridad.

ulTimeout
[Entrada] El tiempo en segundos para esperar a que se complete esta operación. Si este valor es 0, esta función devolverá inmediatamente sin esperar a que se detenga la instancia de LocalDB.

Devoluciones

S_OK
La función se ha realizado correctamente.

LOCALDB_ERROR_NOT_INSTALLED
SQL Server Express LocalDB no está instalado en el equipo.

LOCALDB_ERROR_INVALID_PARAMETER
Uno o varios parámetros de entrada especificados no son válidos.

LOCALDB_ERROR_INVALID_INSTANCE_NAME
El nombre de instancia especificado no es válido.

LOCALDB_ERROR_UNKNOWN_INSTANCE
La instancia no existe.

LOCALDB_ERROR_WAIT_TIMEOUT
Se agota el tiempo de espera al intentar adquirir los bloqueos de sincronización.

LOCALDB_ERROR_INSTANCE_STOP_FAILED
No se pudo completar la operación de detención dentro del tiempo determinado.

LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
La ruta de acceso donde se debe almacenar la instancia es mayor que MAX_PATH.

LOCALDB_ERROR_CANNOT_GET_USER_PROFILE_FOLDER
No se puede recuperar una carpeta de perfil de usuario.

LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER
No se puede tener acceso a una carpeta de instancia.

LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY
No se puede tener acceso a un registro de instancia.

LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
Una configuración de instancia está dañada.

LOCALDB_ERROR_CALLER_IS_NOT_OWNER
El autor de llamada de API no es propietario de la instancia de LocalDB.

LOCALDB_ERROR_INTERNAL_ERROR
Error inesperado. Consulte el registro de eventos para obtener más información.

Observaciones

Para obtener un ejemplo de código que usa la API de LocalDB, consulte Referencia de SQL Server Express LocalDB.

Véase también

Información de versiones y encabezados de SQL Server Express LocalDB