//+-------------------------------------------------------------------------
//
//  Microsoft Windows
//  Copyright (C) Microsoft Corporation, 1999-2000.
//
//  File:       filtereg.idl
//
//  Contents:   Filter registration interface
//
//  History:    Jun-30-1999   cobir        Created
//              Jul-09-2000   cobir        Added IFilterControl
//
//--------------------------------------------------------------------------

import "oaidl.idl";
import "ocidl.idl";
import "filter.idl";


// 9E175B8D-F52A-11D8-B9A5-505054503030
cpp_quote("EXTERN_C const CLSID CLSID_FilterRegistration;")

[
    object,
    uuid(c7310722-ac80-11d1-8df3-00c04fb6ef4f),
    helpstring("ILoadFilter Interface"),
    pointer_default(unique)
]
interface ILoadFilter : IUnknown
{
    typedef struct _FILTERED_DATA_SOURCES
    {
        WCHAR const * pwcsExtension; // file extension
        WCHAR const * pwcsMime;       // mime type string
        CLSID const * pClsid;
        WCHAR const * pwcsOverride;

    } FILTERED_DATA_SOURCES;


    HRESULT LoadIFilter( [in, unique] LPCWSTR pwcsPath,
                         [in, unique] FILTERED_DATA_SOURCES * pFilteredSources,
                         [in, unique] IUnknown * pUnkOuter,
                         [in] BOOL fUseDefault,   // use default filter when no filter is found
                         [in, out, unique] CLSID * pFilterClsid,
                         [in, out, unique] int * SearchDecSize,
                         [in, out, unique, size_is(, *SearchDecSize + 1), length_is(, *SearchDecSize + 1)] WCHAR ** pwcsSearchDesc,
                         [in, out, unique] IFilter **  ppIFilt );



    HRESULT LoadIFilterFromStorage( [in] IStorage * pStg,
                                    [in, unique] IUnknown * pUnkOuter,
                                    [in, unique] LPCWSTR pwcsOverride,
                                    [in] BOOL fUseDefault,
                                    [in, out, unique] CLSID * pFilterClsid,
                                    [in, out, unique] int * SearchDecSize,
                                    [in, out, unique, size_is(, *SearchDecSize + 1), length_is(, *SearchDecSize + 1)] WCHAR ** pwcsSearchDesc,
                                    [in, out, unique] IFilter ** ppIFilt );


    HRESULT LoadIFilterFromStream( [in] IStream * pStm,
                                   [in, unique] FILTERED_DATA_SOURCES *pFilteredSources,
                                   [in, unique] IUnknown * pUnkOuter,
                                   [in] BOOL fUseDefault,
                                   [in, out, unique] CLSID * pFilterClsid,
                                   [in, out, unique] int * SearchDecSize,
                                   [in, out, unique, size_is(, *SearchDecSize + 1), length_is(, *SearchDecSize + 1)] WCHAR ** pwcsSearchDesc,
                                   [in, out, unique] IFilter ** ppIFilt );
};