Remarks
Starts a new recording session from an input sound file that was previously encrypted through the EncryptCurrentSession method or through the CryptSound™ application.
During the recording sessions the container application is notified through the CallbackForRecordersEvents delegate which is invoked with the nEvent parameter set to EV_REC_START at the beginning and to EV_REC_STOP at the end. The current percentage of advancement is notified through the EV_REC_PERC event.
For details about encryption/decryption features see the How to protect your recording sessions through encryption tutorial.
Syntax
[Visual Basic]
Public Function StartFromFileEncrypted (
strOutputPath as String,
strInputPath as String,
strDecryptionKey as String
) as enumErrorCodes
|
|
[C#]
public enumErrorCodes StartFromFileEncrypted (
string strOutputPath,
string strInputPath,
string strDecryptionKey
);
|
|
[C++]
public: enumErrorCodes StartFromFileEncrypted (
string strOutputPath,
string strInputPath,
string strDecryptionKey
);
|
|
Parameter
|
Description
|
|
|
strOutputPath
|
String representing the absolute pathname of the output file that will contain the recorded data. If this pathname should contain invalid characters, they would be automatically changed into an underscore '_' character..
If the string is left empty, the recording session will be performed in memory.
|
strInputPath
|
String representing the absolute pathname of the encrypted input sound file.
|
strDecryptionKey
|
String containing the key used to originally encrypt the song: its length can be from a minimum of 16 characters to a maximum of 32 characters.
|
Return value
Value
|
Meaning
|
|
|
Negative value
|
An error occurred. Check the LastError property value in order to see the last error.
|
enumErrorCodes.ERR_NOERROR (0)
|
The method call was successful.
|
|
