IAccPropServices::ComposeHwndIdentityString メソッド (oleacc.h)

呼び出し元は ComposeHwndIdentityString を使用して ID 文字列を取得します。

構文

HRESULT ComposeHwndIdentityString(
  [in]  HWND  hwnd,
  [in]  DWORD idObject,
  [in]  DWORD idChild,
  [out] BYTE  **ppIDString,
  [out] DWORD *pdwIDStringLen
);

パラメーター

[in] hwnd

種類: HWND

呼び出し元が識別するアクセス可能な要素の HWND を指定します。

[in] idObject

種類: DWORD

アクセスできる要素のオブジェクト ID を指定します。

[in] idChild

種類: DWORD

アクセスできる要素の子 ID を指定します。

[out] ppIDString

型: BYTE**

ID 文字列を受け取るバッファーへのポインター。 呼び出し先は 、CoTaskMemAlloc を使用してこのバッファーを割り当てます。 完了したら、呼び出し元は CoTaskMemFree を呼び出してバッファーを解放する必要があります。

[out] pdwIDStringLen

種類: DWORD*

ID 文字列の長さを受け取るバッファーへのポインター。

戻り値

種類: HRESULT

成功した場合は、S_OK を返します。

hwnd、idObject、または idChild が無効な場合は、E_INVALIDARGを返します。

メモリ不足などの例外的なエラー条件下で、他のエラー コードが返される場合があります。

要件

要件	値
サポートされている最小のクライアント	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