Create ActiveX Server Wizard — Server Advanced Options Panel
You can use this dialog box to specify the following advanced options for an ActiveX server.
- Threading Model—The COM threading model of the server. The default threading model of your server is the Single Threaded model. Refer to www.msdn.com and the COM Threading Models for ActiveX Applications topic for more information about COM Threading Models.
You can choose one of the following threading models for EXE servers:
- Single Threaded—Recommended for servers with user interface components.
- Multi Threaded—Recommended for servers with no user interface components.
You can choose one of the following threading models for DLL servers:
- Single Threaded—Recommended for trivial servers where performance is not critical.
- Apartment Threaded—Recommended for non-trivial servers with user interface components.
- Neutral Threaded—Recommended for non-trivial servers with no user interface components.
- Free Threaded—Recommended for non-trivial servers with specialized requirements. Refer to www.msdn.com for more information.
- Both Threaded—Recommended for non-trivial servers with specialized requirements. Refer to www.msdn.com for more information.
- Both With Free Threaded Marshaller—Obsolete. Use Neutral Threaded.
- Callback Function—The name of an optional callback function for an executable server. The name of the function must be a valid C identifier. If you specify and implement a callback function, it will be called with the CA_SERVER_EVENT_MODULE_EXIT event when the server is ready to exit. If the callback function returns 0 in response to this event, then LabWindows/CVI will quit the user interface loop, and the server will exit. This option applies only to EXE servers. By default, your server does not have a callback function. Refer to the Generating ActiveX Code topic for more information about the semantics of the callback function.
- Major Version—The major version number for your server. The default major version number is 1.
- Minor Version—The minor version number for your server. The default minor version number is 0.
- Requires /Automation in command line—Selecting this option causes the server to run only if the /Automation command line switch is present. This option applies only to EXE servers. By default, this option is disabled. If you enable this option, the initialization function for the server returns false in the runServer output parameter when the EXE is launched by double-clicking the EXE in Windows Explorer. You can detect the false in the runServer parameter and return from the server main function, thus preventing the server from continuing execution.
- Locale ID—The locale identifier for your server.A locale is a collection of language-related, user-preference information. The default locale identifier is 0 and represents the neutral locale.
- GUID (LIBID)—LabWindows/CVI automatically generates a LIBID for your server. You can use a different GUID by entering a new LIBID. You must specify the LIBID in registry format. You can use the guidgen.exe utility from Microsoft to generate GUIDs. For more information and to obtain guidgen.exe, refer to the Microsoft Web site.