ACC: How to Use the Quit Macro Action or Quit Method

ID: Q100149

The information in this article applies to:
Advanced: Requires expert coding, interoperability, and multiuser skills.


SUMMARY

This article demonstrates two methods that you can use to close Microsoft Access from a different application. The first method uses the Quit macro action to quit Microsoft Access over a dynamic data exchange (DDE) channel. The second method uses Automation and the Quit method.


MORE INFORMATION

Dynamic Data Exchange method

The syntax for the Quit action is: 

Quit
There are no parameters for the Quit action.

The following example uses a Microsoft Excel version 4.0 macro to demonstrate the Quit macro action. The macro is valid for Microsoft Excel versions 4.0, 5.0, 7.0, and 97. NOTE: This macro will not work with Microsoft Access version 1.0.

  1. Open a new macro sheet in Microsoft Excel. On the Insert menu, click Macro, and then click MS Excel 4.0 Macro. Enter the following macro:


    2. 
      Cell     Command
      ------------------------------------------------
      A1       QuitDDEExample
      A2
      A3       =APP.MINIMIZE()
      A4       =ERROR(FALSE)
      A5       =APP.ACTIVATE("Microsoft Access",FALSE)
      A6       chan=INITIATE("MSACCESS","system")
      A7       =APP.ACTIVATE("Microsoft Access",FALSE)
      A8       =EXECUTE(chan,"[QUIT]")
      A9       =TERMINATE(chan)
      A10      =APP.ACTIVATE(FALSE)
      A11      =RETURN()
  2. Before running this macro, size your Microsoft Access and Microsoft Excel windows so that you can view both applications at the same time.


  3. To run the macro, select cell A3. On the Tools menu, click Macro. In the Macro box, click Run.


Automation Method

This method is exclusive to Microsoft Access 7.0 and 97. Earlier versions of Microsoft Access are not OLE Servers, and therefore you can't manipulate them by using Automation.
  1. Open Microsoft Access.


  2. Open Microsoft Excel (or another OLE server) and create a new macro. On the Insert menu, click Macro, and then click Module. This will insert a new module in the current book.


  3. Type the following Sub procedure:


    4. 
      Sub OleAccess()
         Dim appAccess as Object
         Set appAccess = GetObject(, "Access.Application")
         appAccess.Quit acSave
      End Sub
  4. To run this code, click Start on the Run menu, or call the Sub procedure from another procedure. When it runs, the GetObject() function is executed, setting the appAccess variable to the first available open instance of Microsoft Access. At the end, it closes Microsoft Access with appAccess.Quit.


Note that you will get a run-time error if you don't have Microsoft Access loaded in the background when you run the procedure. You can trap for this error by using On Error.


REFERENCES

For more information about the Quit method, search the Help Index for "Quit method," or ask the Microsoft Access 97 Office Assistant.

For more information about using macro actions in DDE, please see the following article here in the Microsoft Knowledge Base:

Q97776 ACC: Running a MS Access Macro from Visual Basic Using DDE

Additional query words: ole/dde server 


Keywords          : kbinterop kbdta AccCon IntpOlea KbVBA 
Version           : WINDOWS:1.1,2.0,7.0,97
Platform          : WINDOWS 
Issue type        : kbhowto

Last Reviewed: August 2, 1999