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] Un valor de marcador o una combinación de ellos que especifican la forma en la que detener la instancia.

  Marcadores disponibles:

  • LOCALDB_SHUTDOWN_KILL_PROCESS
    Cierre inmediato mediante el comando del sistema operativo de eliminar proceso.

  • LOCALDB_SHUTDOWN_WITH_NOWAIT
    Cierre mediante el comando de Transact-SQL de la opción WITH NOWAIT.

  Si no se establece ningún marcador, la instancia de LocalDB se cerrará con el comando de Transact-SQL SHUTDOWN. Si se han establecido ambos marcadores, tiene prioridad el marcador LOCALDB_SHUTDOWN_KILL_PROCESS.

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

Devuelve

• 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 más parámetros de entrada especificados no son válidos.

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

• LOCALDB_ERROR_UNKNOWN_INSTANCE
  La instancia no existe.

• LOCALDB_ERROR_WAIT_TIMEOUT
  Se ha agotado el tiempo de espera mientras se intentaba adquirir bloqueos de sincronización.

• LOCALDB_ERROR_INSTANCE_STOP_FAILED
  La operación de detención no pudo completarse dentro del tiempo especificado.

• LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
  La ruta de acceso donde la instancia debe almacenarse 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 la instancia.

• LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY
  No se puede tener acceso a un registro de la 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 la API no es propietario de la instancia de LocalDB.

• LOCALDB_ERROR_INTERNAL_ERROR
  Se ha producido un error imprevisto. Vea el registro de eventos para obtener detalles.

Comentarios

Para obtener un ejemplo de código que utilice LocalDB API, vea Referencia de SQL Server Express LocalDB.

Vea también

Conceptos

Información de encabezado y versión de SQL Server Express LocalDB