IAccIdentity::GetIdentityString メソッド (oleacc.h)

アクセス可能な要素を一意に識別するバイトの文字列 (ID 文字列) を取得します。

サーバー開発者は、注釈を付けるオブジェクトの HWND を認識している場合、このメソッドを使用して ID 文字列を取得する代わりに、次のいずれかのメソッドを使用できます。

• IAccPropServices::SetHwndPropStr
• IAccPropServices::SetHwndProp
• IAccPropServices::SetHwndPropServer

構文

HRESULT GetIdentityString(
  [in]  DWORD dwIDChild,
  [out] BYTE  **ppIDString,
  [out] DWORD *pdwIDStringLen
);

パラメーター

[in] dwIDChild

種類: DWORD

呼び出し元が識別する IAccessible オブジェクトの子を指定します。

[out] ppIDString

型: BYTE**

呼び出し先によって割り当てられた ID 文字列へのポインターを受け取る変数のアドレス。 呼び出し先は 、CoTaskMemAlloc を使用して ID 文字列を割り当てます。呼び出し元は、完了したら CoTaskMemFree を使用して ID 文字列を解放する必要があります。

[out] pdwIDStringLen

種類: DWORD*

呼び出し先によって割り当てられた ID 文字列の長さ (バイト単位) を受け取る変数のアドレス。

戻り値

種類: HRESULT

メモリ不足などの例外的なエラー条件下を除き、S_OKを返します。 サポートされていない場合、IAccIdentity で QueryInterface を呼び出すことは失敗します。

解説

返される文字列は不透明と見なす必要があります。クライアントは、全体としてのみ使用する必要があり、それを解剖したり、手動で解釈したりしないでください。

クライアントは、文字列が HWND ベースであることを認識または予期している場合は、 IAccPropServices::D ecomposeHwndIdentityString を使用して ID 文字列の分解を試みることができます。

要件

サポートされている最小のクライアント	Windows Vista または Windows XP
サポートされている最小のサーバー	Windows Server 2003
対象プラットフォーム	Windows
ヘッダー	oleacc.h (最初に OleAcc.h Initguid.h を含める)
[DLL]	Oleacc.dll
再頒布可能パッケージ	SP6 以降および Windows 98 を使用した Windows NT 4.0 の Active Accessibility 2.0 RDK