IUIAutomationElement::GetRuntimeId メソッド (uiautomationclient.h)

UI 要素に割り当てられた一意の識別子を取得します。

構文

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

[out, retval] runtimeId

種類: SAFEARRAY**

ランタイム ID へのポインターを整数の配列として受け取ります。

型: HRESULT

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

識別子は、それが生成されたデスクトップの UI にのみ一意であることが保証されます。識別子は時間の経過と同時に再利用できます。

ランタイム識別子の形式は、将来変更される可能性があります。返される識別子は不透明な値として扱い、比較にのみ使用する必要があります。たとえば、Microsoft UI オートメーション要素がキャッシュ内にあるかどうかを判断します。

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