Método IDebugHostExtensibility::CreateFunctionAlias (dbgmodel.h)
O método CreateFunctionAlias cria um "alias de função", um "alias rápido" para um método implementado em alguma extensão. O significado desse alias é específico do host. Ele pode estender o avaliador de expressão do host com a função ou pode fazer algo totalmente diferente.
Para Ferramentas de Depuração para Windows, um alias de função:
É acessível no avaliador de expressão por meio do símbolo @$. Um alias de função registrado em someName pode ser chamado no avaliador por meio de @$someName(...).
Pode ser invocado por meio da sintaxe bang mais antiga. A invocação "!someName arg1, arg2, ..." é semanticamente equivalente a executar o avaliador de expressão (dx) com "@$someName(arg1, arg2, ...)" e exibir o resultado.
Sintaxe
HRESULT CreateFunctionAlias(
PCWSTR aliasName,
IModelObject *functionObject
);
Parâmetros
aliasName
O nome (rápido) do alias que está sendo criado/registrado.
functionObject
Um método de modelo de dados (um IModelMethod boxed em um IModelObject) que implementa a funcionalidade do alias da função.
Retornar valor
Esse método retorna HRESULT que indica êxito ou falha.
Comentários
Código de exemplo
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"
}
}
}
}
Requisitos
Requisito | Valor |
---|---|
Cabeçalho | dbgmodel.h |