// msdbg171.idl
/********************************************************
*                                                        *
*   Copyright (C) Microsoft. All rights reserved.        *
*                                                        *
*********************************************************/
cpp_quote("/********************************************************")
cpp_quote("*                                                        *")
cpp_quote("*   Copyright (C) Microsoft. All rights reserved.        *")
cpp_quote("*                                                        *")
cpp_quote("*********************************************************/")
import "oaidl.idl";
import "ocidl.idl";

#ifndef DEBUGGER_PIA_BUILD
import "msdbg.idl";
import "msdbg156.idl";
#endif

#ifdef DEBUGGER_PIA_BUILD
#define XINT32 int
#else
#define XINT32 ULONG32
#endif

//----------------------------------------------------------------------------
// IAsyncDebugGenerateSymbolsCompletionHandler
//----------------------------------------------------------------------------
[
    local,
    object,
    uuid(9793488F-FDC3-412B-9DA0-E3263BB85168),
    pointer_default(unique)
]
interface IAsyncDebugGenerateSymbolsCompletionHandler : IUnknown
{
    // Called when symbol generation has completed.
    HRESULT OnComplete(
        [in] HRESULT hr
        );
};

// Optional interface that can be implemented by objects that implement IDebugModule* to allow generation
//  of symbols with embedded source, e.g. by decompilation.
// NOTE:  Implementations of this interface must ensure that the completion handler is invoked on the
//   UI thread.
[
    object,
    uuid(B87A14E2-774C-488D-8301-91858929163A),
    pointer_default(unique)
]
interface IDebugModule171 : IUnknown
{
    // Determines whether the module supports symbol generation with embedded source.
    HRESULT CanGenerateSymbols(
        [out] BOOL* pfRetVal
    );

    // Generate symbols for the module.  Implementations must ensure that the completion handler is invoked on
    //  the UI thread.
    HRESULT GenerateSymbolsAsync(
        [in] IAsyncDebugGenerateSymbolsCompletionHandler* pCompletionHandler,
        [out] IAsyncDebugEngineOperation** ppDebugOperation
    );
};