BinaryObjectScanner/BinaryObjectScanner.Interfaces/IExtractable.cs

using System.IO;

namespace BinaryObjectScanner.Interfaces
{
    /// <summary>
    /// Mark a file type as being able to be extracted
    /// </summary>
    public interface IExtractable
    {
        /// <summary>
        /// Scan a file for all internal protections
        /// </summary>
        /// <param name="file">Path to the input file</param>
        /// <returns>Path to extracted files, null on error</returns>
        /// <remarks>
        /// Ideally, this should just point to the other extract implementation.
        /// It is expected that the calling method will provide exception handling.
        /// </remarks>
        string Extract(string file);

        /// <summary>
        /// Scan a stream for all internal protections
        /// </summary>
        /// <param name="stream">Stream representing the input file</param>
        /// <param name="file">Path to the input file</param>
        /// <returns>Path to extracted files, null on error</returns>
        /// <remarks>It is expected that the calling method will provide exception handling.</remarks>
        string Extract(Stream stream, string file);
    }
}