VCInitSounds

Version:

5.0

Description:

Initializes the sound registry entries used by VCSound

Declaration:

C/C++

extern "C" vbool WINAPI VCInitSounds(short* iError, char* AppName, char* ExeName);

Delphi

function VCInitSounds(var IError: SmallInt; var AppName: PAnsiChar; var ExeName: PAnsiChar):WordBool; stdcall;

ActiveX/COM

Function InitSounds(ByVal AppName As String, ByVal ExeName As String) As Integer

Parameters:

AppName - pointer to a NULL terminated string with the desired user friendly name displayed in the Control Panel Sounds applet
ExeName - pointer to NULL terminated string with the Windows recognized application name

Return Value:

TRUE - Success

iError Code:

0 - Success
1 - No valid frame window (VCADD DLLs not correctly initialized with VCInit)
2 - Current application is Visual CADD™

Notes:

The VCSound function uses sounds defined by .wav files specified in the registry. The .wav files associated with the sounds can be edited with the Control Panel Sounds applet.

When VCADD starts, it initializes the registry entries to ensure that they are available. Stand-alone EXEs wishing to use VCSound must first call VCInitSounds to ensure that the registry is correctly set up and that VCADD's internal sound variables are initialized. The default VCADD sounds can be used by setting either or both of AppName and ExeName to NULL. When VCSound is called from a DLL called by VCADD5.EXE, a call to VCInitSounds is not required and will fail.