IAccPropServices::D ecomposeHwndIdentityString メソッド (oleacc.h)

このメソッドを使用して、ID 文字列によって識別されるアクセス可能な要素の HWND、オブジェクト ID、および子 ID を決定します。

構文

HRESULT DecomposeHwndIdentityString(
  [in]  const BYTE *pIDString,
  [in]  DWORD      dwIDStringLen,
  [out] HWND       *phwnd,
  [out] DWORD      *pidObject,
  [out] DWORD      *pidChild
);

パラメーター

[in] pIDString

型: const BYTE*

HWND ベースのアクセス可能な要素の ID 文字列を含むバッファーへのポインター。

[in] dwIDStringLen

型: DWORD

pIDString によって指定される ID 文字列の長さを指定します。

[out] phwnd

種類: HWND*

アクセス可能な要素の HWND を受け取るバッファーへのポインター。

[out] pidObject

型: DWORD*

アクセスできる要素のオブジェクト ID を受け取るバッファーへのポインター。

[out] pidChild

型: DWORD*

アクセスできる要素の子 ID を受け取るバッファーへのポインター。

戻り値

型: HRESULT

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

phwnd、pidObject、または pidChild が無効な場合、または指定された ID 文字列が HWND ベースの ID 文字列でない場合は、E_INVALIDARGを返します。

メモリ不足などの例外的なエラー状態で他のエラー コードを返す場合があります。

注釈

このメソッドは、指定された ID 文字列が HWND ベースの ID 文字列である場合にのみ成功します。 このメソッドは、指定された ID 文字列から、クライアントがサーバーを呼び出している子要素 (idChild) をサーバーが判断できるため、ANNO_CONTAINER スコープに登録された IAccPropServer コールバック サーバーで使用する場合に便利です。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	oleacc.h (最初に OleAcc.h を含める Initguid.h を含めます。
[DLL]	Oleacc.dll
再頒布可能パッケージ	SP6 以降および Windows 98 を使用した Windows NT 4.0 のアクティブなアクセシビリティ 2.0 RDK