Método Connection.Cancel (DAO)

Se aplica a: Access 2013, Office 2013

Sintaxis

expresión . Cancelar

expression Variable que representa un objeto Connection.

Comentarios

Use el método Cancel para finalizar la ejecución de una llamada asincrónica al método Execute o OpenConnection (es decir, el método se invocó con la opción dbRunAsync). Cancel devolverá un error en tiempo de ejecución si dbRunAsync no se usó en el método que intenta finalizar.

Se producirá un error si, después de una llamada al método Cancel, intenta hacer referencia al objeto que debería haber sido creado por una llamada a OpenConnection asincrónica (es decir, el objeto Connection desde el que llamó al método Cancel).

Ejemplo

En este ejemplo se utilizan la propiedad StillExecuting y el método Cancel para abrir de forma asincrónica un objeto Connection.

    Sub CancelConnectionX() 
     
     Dim wrkMain As Workspace 
     Dim conMain As Connection 
     Dim sngTime As Single 
     
     Set wrkMain = CreateWorkspace("ODBCWorkspace", _ 
     "admin", "", dbUseODBC) 
     ' Open the connection asynchronously. 
     
     ' Note: The DSN referenced below must be configured to 
     ' use Microsoft Windows NT Authentication Mode to 
     ' authorize user access to the Microsoft SQL Server. 
     Set conMain = wrkMain.OpenConnection("Publishers", _ 
     dbDriverNoPrompt + dbRunAsync, False, _ 
     "ODBC;DATABASE=pubs;DSN=Publishers") 
     
     sngTime = Timer 
     
     ' Wait five seconds. 
     Do While Timer - sngTime < 5 
     Loop 
     
     ' If the connection has not been made, ask the user 
     ' if she wants to keep waiting. If she does not, cancel 
     ' the connection and exit the procedure. 
     Do While conMain.StillExecuting 
     
     If MsgBox("No connection yet--keep waiting?", _ 
     vbYesNo) = vbNo Then 
     conMain.Cancel 
     MsgBox "Connection cancelled!" 
     wrkMain.Close 
     Exit Sub 
     End If 
     
     Loop 
     
     With conMain 
     ' Use the Connection object conMain. 
     .Close 
     End With 
     
     wrkMain.Close 
     
    End Sub