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

サーバーは ClearProps を 使用して、以前に注釈を付けたアクセス可能な要素のプロパティに既定値を復元します。

サーバーがクリアするオブジェクトの HWND を認識している場合は、 IAccPropServices::ClearHwndProps を使用できます。

構文

HRESULT ClearProps(
  [in] const BYTE       *pIDString,
  [in] DWORD            dwIDStringLen,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps
);

パラメーター

[in] pIDString

型: const BYTE*

注釈付けの対象とならない、アクセスできる要素を識別します。

[in] dwIDStringLen

型: DWORD

pIDString の長さ。

[in] paProps

型: const MSAAPROPID*

リセットされるプロパティの配列を指定します。 これらのプロパティは、注釈が付けられる前の既定の動作に戻ります。

[in] cProps

型: int

paProps 配列のサイズ。

戻り値

型: HRESULT

成功した場合、 は、指定したプロパティにアクセス可能なオブジェクトに注釈が付けたことがない場合でも、S_OKを返します。既にクリアされているプロパティのクリアは成功と見なされます。

paProps 配列のプロパティのいずれかがサポートされていない場合は、E_INVALIDARGを返します。

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

注釈

サポートされているプロパティとその想定される型の一覧については、サポート セクションを参照してください。

プロパティの注釈をクリアすると、関連付けられているリソースが解放されます。 コールバック プロパティ サーバーが使用された場合 ( SetPropServer を参照)、そのサーバーは解放されます。

要件

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