戻り値 (Windows アクセシビリティ機能)

このトピックでは、最も一般的な戻り値と、表示頻度が低い可能性があるその他の戻り値について説明します。

一般的な戻り値

IAccessible メソッドは、winerror.h で定義されている次のいずれかの値、または別の標準コンポーネント オブジェクト モデル (COM) エラー コードを返します。

価値	形容
S_OK	メソッドは成功しました。
S_FALSE	メソッドの一部が成功しました。 これは、メソッドが成功したが、要求された情報が使用できない場合に発生します。 たとえば、IAccessible::accHitTest を呼び出して特定の時点で子オブジェクトを取得し、指定したポイントがオブジェクトまたはオブジェクトの子内にない場合、Microsoft Active Accessibility はS_FALSEを返します。
DISP_E_MEMBERNOTFOUND	オブジェクトは、要求されたプロパティまたはアクションをサポートしていません。 たとえば、Value プロパティを要求した場合、プッシュ ボタンはこの値を返します。これは、Value プロパティがないためです。
E_NOTIMPL	メソッドは実装されていません。 この値は、クライアントがそのオペレーティング システムでまだサポートされていないメソッドを呼び出すときに発生します。
E_INVALIDARG	1 つ以上の引数が無効でした。 このエラーは、呼び出し元が、サーバーが認識しない識別子を使用して子オブジェクトを識別しようとしたときに発生します。 このエラーは、クライアントが子を持たないオブジェクト内の子オブジェクトを識別しようとしたときにも発生します。
E_OUTOFMEMORY	メソッドは、成功に不可欠な操作を完了するために必要なメモリを割り当てることができませんでした。
E_FAIL	不明なエラーまたは一般的なエラーが発生しました。

 

その他の戻り値

IAccessibleメソッド返される戻り値を次に示します。 これらの戻り値は、前の戻り値ほど一般的ではありませんが、注意する必要があります。

価値	形容
E_ACCESSDENIED	これは、get_accValueを呼び出してパスワード コントロールの値を取得するときに返されます。
DISP_E_EXCEPTION
CO_E_OBJNOTCONNECTED