通过UIA_AutomationIdPropertyId查找UI元素失败问题排查

我需要获取一个仅能通过UIA_AutomationIdPropertyId识别的组元素，已从Inspect.exe中获取到对应的AutomationId，并编写了FindBy_UIA_AID函数。但该函数始终返回nullptr且无报错，经确认目标元素属于MainElement的子树节点。此前编写的通过UIA_LegacyIAccessibleNamePropertyId查找同范围元素的FindBy_UIA_NPI函数可正常工作。手动遍历MainElement的所有子元素时发现，许多在Inspect.exe中显示有AutomationID的元素实际无该属性，现寻求问题原因及解决办法。

按AutomationId查找元素的函数 #

IUIAutomationElement* FindBy_UIA_AID(std::wstring UID)
{
    IUIAutomationElement* pElement = nullptr;
    IUIAutomationCondition* condition = nullptr;
    
    VARIANT var{};
    var.bstrVal = SysAllocStringLen(UID.c_str(), UID.size());
    var.vt = VT_BSTR;

    hr = pAutomation->CreatePropertyCondition(UIA_AutomationIdPropertyId, var, &condition);
    if (FAILED(hr))
    {
        std::cout << "Error Creating Condition\n";
        return nullptr;
    }

    hr = MainElement->FindFirst(TreeScope_Subtree, condition, &pElement);
    if (FAILED(hr))
    {
        std::cout << "Error Finding First Occurence\n";
        condition->Release();
        return nullptr;
    }

    condition->Release();
    SysFreeString(var.bstrVal);
    return pElement;
}

按LegacyIAccessibleName查找元素的函数 #

IUIAutomationElement* FindBy_UIA_NPI(std::wstring name)
{
    IUIAutomationElement* pElement = nullptr;
    IUIAutomationCondition* condition = nullptr;

    VARIANT var{};
    var.bstrVal = SysAllocStringLen(name.c_str(), name.size());
    var.vt = VT_BSTR;

    hr = pAutomation->CreatePropertyCondition(UIA_LegacyIAccessibleNamePropertyId, var, &condition);
    if (FAILED(hr))
    {
        std::cout << "Error Creating Condition\n";
        return nullptr;
    }

    hr = MainElement->FindFirst(TreeScope_Subtree, condition, &pElement);
    if (FAILED(hr))
    {
        std::cout << "Error Finding First Occurence\n";
        condition->Release();
        return nullptr;
    }

    SysFreeString(var.bstrVal);
    condition->Release();

    return pElement;
}

类成员变量 #

HRESULT hr{};
HWND hwnd{};
IUIAutomation* pAutomation{};
IUIAutomationElement* MainElement{};

可能原因 #

1. Inspect.exe显示的AutomationID并非原生UIA属性：部分控件的AutomationID是通过LegacyIAccessible桥接层暴露的，并非UIA原生的UIA_AutomationIdPropertyId属性。Inspect.exe会统一展示这些属性，但实际通过UIA API查询时，原生属性可能未被设置。
2. BSTR创建逻辑存在隐患：SysAllocStringLen手动指定长度的方式，若输入字符串包含截断符或长度计算错误，会导致BSTR内容异常，无法匹配目标元素。
3. 属性匹配的细节差异：传入的UID与目标元素实际属性值存在大小写、空格或特殊字符的差异，导致匹配失败。

解决办法 #

1. 验证目标元素的真实属性：
   遍历子元素时，调用IUIAutomationElement::GetCurrentPropertyValue直接查询UIA_AutomationIdPropertyId，确认目标元素是否真的持有该属性。若返回VT_EMPTY，说明Inspect.exe显示的是Legacy层属性，需改用UIA_LegacyIAccessibleAutomationIdPropertyId创建查询条件。
2. 修正BSTR创建方式：
   用SysAllocString替代SysAllocStringLen，该函数会自动计算宽字符串长度，避免手动指定长度导致的错误：

   var.bstrVal = SysAllocString(UID.c_str());
   

3. 添加调试验证步骤：
   在遍历子元素时，打印每个元素的AutomationID（若存在），确认目标元素的实际ID与传入的UID完全一致；同时在创建条件后，可输出条件对应的属性值，验证条件是否正确生成。
4. 检查UIA初始化配置：
   确认pAutomation初始化时是否启用了Legacy控件支持，默认的CoCreateInstance(CLSID_CUIAutomation, nullptr, CLSCTX_INPROC_SERVER, IID_IUIAutomation, ...)配置是支持的，但部分特殊控件可能需要额外设置过滤规则（如禁用元素可见性过滤）。

内容的提问来源于stack exchange，提问作者Sheyteo