IDebugHostExtensibility3：：CreateFunctionAlias 方法 （dbgmodel.h）

CreateFunctionAlias 方法會建立「函式別名」，這是某些擴充中實作之方法的「快速別名」。 此別名的意義為主機特定。 它可能會使用 函式來擴充主機的表達式評估工具，或者它可能會執行完全不同的動作。

針對 Windows 的偵錯工具，函式別名：

• 可透過 @$ 符號在表達式評估工具中存取。 在 someName 下註冊的函式別名可透過 @$someName（...） 在評估工具中呼叫。

• 可以透過較舊的 bang 語法叫用。 調用 “！someName arg1， arg2， ...”在語意上相當於使用 「@$someName（arg1， arg2， ...） 執行運算式評估工具，並顯示結果。

語法

HRESULT CreateFunctionAlias(
  PCWSTR       aliasName,
  IModelObject *functionObject
);

參數

aliasName

正在建立/註冊之別名的 （quick） 名稱。

functionObject

實作函式別名功能的數據模型方法（IModelMethod boxed 到 IModelObject）。

傳回值

此方法會傳回 HRESULT，指出成功或失敗。

言論

範例程式代碼

class MySumFunction:
    public Microsoft::WRL::RuntimeClass<
        Microsoft::WRL::RuntimeClassFlags<
            Microsoft::WRL::RuntimeClassType::ClassicCom
            >,
        IModelMethod
        >
{
public:

    IFACEMETHOD(Call)(_In_ IModelObject * /*pContextObject*/, 
                      _In_ ULONG64 argCount, 
                      _In_reads_(argCount) IModelObject **ppArguments, 
                      _COM_Errorptr_ **ppResult)
    {
        HRESULT hr = S_OK;
        *ppResult = nullptr;

        if (argCount == 0)
        {
            return E_INVALIDARG;
        }

        int sum = 0;
        for (ULONG64 i = 0; i < argCount; ++i)
        {
            VARIANT vtValue;
            if (FAILED(ppArguments[i]->GetIntrinsicValueAs(&vtValue)))
            {
                return E_INVALIDARG;
            }
            sum += vtValue.lVal;
        }

        VARIANT vtSum;
        vtSum.vt = VT_I4;
        vtSum.lVal = sum;

        ComPtr<IModelObject> spSum;
        hr = GetManager()->CreateIntrinsicObject(ObjectIntrinsic, &vtSum, &spSum);
        if (SUCCEEDED(hr))
        {
            *ppResult = spSum.Detach();
        }

        return hr;
    }
};

// Create a method object and register it as a function alias.
ComPtr<MySumFunction> spSumFunc = Microsoft::WRL::Make<MySumFunction>();
if (spSumFunc != nullptr)
{
    VARIANT vtMethod;
    vtMethod.vt = VT_UNKNOWN;
    vtMethod.punkVal = static_cast<IModelMethod *>(spSumFunc.Get());
    
    ComPtr<IModelObject> spMethodObject;
    if (SUCCEEDED(GetManager()->CreateIntrinsicObject(ObjectMethod, 
                                                      &vtMethod, 
                                                      &spMethodObject)))
    {
        ComPtr<IDebugHostExtensibility> spHostExtensibility;
        if (SUCCEEDED(GetHost()->QueryInterface(IID_PPV_ARGS(&spHostExtensibility)))
        {
            if (SUCCEEDED(spHostExtensibility->CreateFunctionAlias(
                L"sumit",
                spMethodObject.Get())))
            {
                // sumit is now an alias for our function.  The meaning here 
                // is host specific.  For DbgEng, it means you can do things
                // like "dx @$sumit(5, 7, 8)" or "!sumit 5, 7, 8"
            }
        }
    }
}

要求

要求	價值
標頭	dbgmodel.h

另請參閱

IDebugHostExtensibility3 介面