Método IRawElementProviderFragment::GetRuntimeId (uiautomationcore.h)

Recupera o identificador de runtime de um elemento.

Sintaxe

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

Parâmetros

[out, retval] pRetVal

Tipo: SAFEARRAY**

Recebe um ponteiro para o identificador de runtime. Este parâmetro é passado não inicializado.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

As implementações devem retornar NULL para um elemento de nível superior hospedado em uma janela. Outros elementos devem retornar uma matriz que contenha UiaAppendRuntimeId (definida em Uiautomationcoreapi.h), seguida por um valor exclusivo dentro de uma instância do fragmento.

Exemplos

A implementação a seguir para um item de lista retorna um identificador de runtime composto pela constante UiaAppendRuntimeId e o índice do item na lista.

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;
}   

Requisitos

Confira também

Práticas recomendadas para usar matrizes seguras

Conceitual

Irawelementproviderfragment

Referência