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

サーバーは SetPropServer を使用して、アクセス可能な要素のプロパティの配列に注釈を付けるために使用するコールバック オブジェクトを指定します。 注釈をこのアクセス可能な要素に適用するか、要素とその子に適用するかを指定することもできます。 このメソッドは、サーバー注釈に使用 されます。

サーバー開発者は、注釈を付けるアクセス可能な要素の HWND を認識している場合は、 IAccPropServices::SetHwndPropServer を使用できます。

構文

HRESULT SetPropServer(
  [in] const BYTE       *pIDString,
  [in] DWORD            dwIDStringLen,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps,
  [in] IAccPropServer   *pServer,
  [in] AnnoScope        annoScope
);

パラメーター

[in] pIDString

型: const BYTE*

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

[in] dwIDStringLen

種類: DWORD

pIDString パラメーターによって識別される文字列の長さを指定します。

[in] paProps

型: const MSAAPROPID*

指定されたコールバック オブジェクトによって処理されるプロパティの配列を指定します。

[in] cProps

型: int

指定されたコールバック オブジェクトによって処理されるプロパティの配列を指定します。

[in] pServer

種類: IAccPropServer*

オーバーライドされたプロパティのいずれかがクライアントによって要求されたときに呼び出されるコールバック オブジェクトを指定します。

[in] annoScope

種類: AnnoScope

指定されたアクセスできる要素にのみ注釈が作用する場合は ANNO_THIS を、要素とその直接の子要素に注釈が適用される場合は ANNO_CONTAINER を指定します。

戻り値

種類: HRESULT

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

paProps 配列のいずれかのプロパティがサポートされていない場合、ID 文字列が無効な場合、または annoScope がANNO_THISまたはANNO_CONTAINERのいずれかでない場合は、E_INVALIDARGを返します。

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

解説

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

注釈の実行時には 、AddRef を使用して 、pServer コールバック オブジェクトの参照カウンターを適切にインクリメントします。 呼び出し元は、このメソッドを呼び出した後に 解放 できます。 注釈の実行時には、注釈が付けられているアクセス可能な要素が使用されなくなった後に、コールバック オブジェクトが自動的に解放されます。

要件

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