共用方式為

IRawElementProviderFragment：：GetRuntimeId 方法 (uiautomationcore.h)

  • 發行項

擷取項目的執行階段識別項。

語法

HRESULT GetRuntimeId(
  [out, retval] SAFEARRAY **pRetVal
);

參數

[out, retval] pRetVal

類型： SAFEARRAY**

接收執行時間識別碼的指標。 這個參數會以未初始化的狀態傳遞。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

實作應該會針對裝載于視窗中的最上層專案傳回 Null 。 其他元素應該傳回陣列，其中包含 UiaAppendRuntimeId (定義于 Uiautomationcoreapi.h) ，後面接著片段實例內唯一的值。

範例

下列清單專案的實作會傳回 由 UiaAppendRuntimeId 常數和清單中專案索引組成的執行時間識別碼。

HRESULT STDMETHODCALLTYPE ListItemProvider::GetRuntimeId(SAFEARRAY ** pRetVal)
{
    if (pRetVal == NULL) 
    {
        return E_INVALIDARG;
    }
    
    int rId[] = { UiaAppendRuntimeId, m_itemIndex };
    SAFEARRAY *psa = SafeArrayCreateVector(VT_I4, 0, 2);
    if (psa == NULL)
    {
        return E_OUTOFMEMORY;
    }
    
    for (LONG i = 0; i < 2; i++)
    {
        SafeArrayPutElement(psa, &i, (void*)&(rId[i]));
    }
    
    *pRetVal = psa;
    return S_OK;
}

規格需求

   
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 uiautomationcore.h (包含 UIAutomation.h)

另請參閱

使用安全陣列的最佳做法

概念

IRawElementProviderFragment

參考