IAccessibleEx::GetRuntimeId メソッド (uiautomationcore.h)

この要素のランタイム識別子を取得します。

構文

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

パラメーター

[out] pRetVal

種類: SAFEARRAY**

ランタイム識別子へのポインターを受け取ります。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

ランタイム識別子は、プロバイダー定義の整数の配列であり、最初の項目は UiaAppendRuntimeId である必要があります。 ランタイム識別子は、親ウィンドウ内で一意である必要があります。

MSAA から UIA へのプロキシは、ランタイム識別子 (ウィンドウ ハンドルと共に) を使用して、2 つのインターフェイス インスタンスが同じ基になる要素を参照しているかどうかを判断します。 IAccessibleEx::GetRuntimeId が実装されていない場合、プロキシは 2 つの IAccessible オブジェクトに対してフィールドごとの比較を実行して、それらが同等であるかどうかを判断します。これは効率が低くなります。

要件

   
サポートされている最小のクライアント Windows 7、Windows Vista SP2 および Windows Vista 用プラットフォーム更新プログラム、SP3 を使用した Windows XP、Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム、WINDOWS Server 2003 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー uiautomationcore.h (UIAutomation.h を含む)

関連項目

安全な配列を使用するためのベスト プラクティス

概念

IAccessibleEx

参照