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

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

構文

HRESULT DecomposeHmenuIdentityString(
  [in]  const BYTE *pIDString,
  [in]  DWORD      dwIDStringLen,
  [out] HMENU      *phmenu,
  [out] DWORD      *pidChild
);

パラメーター

[in] pIDString

型: const BYTE*

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

[in] dwIDStringLen

種類: DWORD

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

[out] phmenu

種類: HMENU*

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

[out] pidChild

種類: DWORD*

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

戻り値

種類: HRESULT

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

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

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

注釈

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

要件

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