VCSetAlertAppDllEx


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 -
0: success
1: failed - An AlertApp with the same DllName and NativeCmd parameters is already set .

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