Version: |
2.0.4 |
Description: |
Registers an external DLL and its exported functions callback with Visual CADD™, enabling messages to be sent back to the application when the specified events have occurred. This call is the same as VCSetAlertAppDll, except that with the addition of a second iCode parameter (iCode1), it can handle a larger range of alert codes. |
Declaration: |
|
C/C++ |
extern "C" void WINAPI VCSetAlertAppDllEx(short* iError, char* DllName, char* NativeCmd, long iCode0, long iCode1); |
Delphi |
procedure VCSetAlertAppDllEx (var iError: Smallint; DllName: PAnsiChar; NativeCmd: PAnsiChar; iCode0: Longint; iCode1: Longint); stdcall; |
ActiveX/COM |
Sub SetAlertAppDllEx(ByVal DllName As String, ByVal NativeCmd As String, ByVal iCode0 As Long, ByVal iCode1 As Long) |
Parameters: |
iError - DllName - The name of the external DLL to receive the callback messages. If the DLL does not reside in the same directory as the Visual CADD™ DLLs, a path needs to be included. NativeCmd - The name which prefixes the function names in the exported callbacks functions defined in the external DLL. iCode0 - Specifies the alerts the external application wants to be notified of. This parameter can be a combination of the iCode0 flags specified in Alert Callbacks. If you do not want to be notified of any iCode0 events set the iCode0 flag to ALERT_APP_NONE. iCode1 - Specifies the extended alerts the external application wants to be notified of. This parameter can be a combination of the iCode1 flags specified in Alert Callbacks. If you do not want to be notified of any iCode1 events set the iCode1 flag to 0. |
Notes: |
VCSetAlertAppDllEx is used by a DLL to request notification (alerts) of certain events in Visual CADD™. The notifications take the form of callbacks to functions exported from the DLL. This approach is significantly more efficient than the messaging used by VCSetAlertApp and VCSetAlertAppEx. |
See Also: |
VCClearAlertAppDll, SetAlertEvent, VCSetAlertAppEx, VCSetAlertAppDll, VCClearAlertApp |