IAssocHandler::IsRecommended メソッド (shobjidl_core.h)

クエリ対象のファイルの種類の推奨ハンドラーとしてアプリケーションが登録されているかどうかを示します。

構文

HRESULT IsRecommended();

戻り値

種類: HRESULT

プログラムが推奨される場合は、S_OKを返します。それ以外の場合は、S_FALSE。

解説

特定のファイルの種類のハンドラーとして自分自身を登録するアプリケーションでは、推奨されるハンドラーかどうかを指定できます。 これは、起動時のアプリケーションの実際の動作には影響しません。 これは、単にユーザーへのヒントと、必要に応じて UI がプログラムで利用できる値として提供されます。 たとえば、シェルの [Open With]\(シェルで開く\ ) ダイアログでは、エントリが [推奨プログラム ] と [その他のプログラム] に分割されます。

プログラムの推奨事項は、時間の経過と同時に変更される可能性があることに注意してください。 1 つの例は、ユーザーが [開くプログラム] ダイアログの[その他のプログラム] からアプリケーションを選択し、特定のファイルの種類を開くときに提供されます。 これにより、シェルがそのアプリケーションをそのファイルの種類の推奨状態に "昇格" する可能性があります。 推奨される状態は時間の経過と同時に変化する可能性があるため、アプリケーションはこの値をキャッシュするのではなく、必要なたびにクエリを実行する必要があります。

SHAssocEnumHandlers が ASSOC_FILTER_RECOMMENDED フラグで呼び出された場合は、推奨されるハンドラーのみが返されます。 ASSOC_FILTER_NONE フラグが使用された場合は、各 IAssocHandler オブジェクトで IAssocHandler::IsRecommended を呼び出して、推奨されるかどうかを判断する必要があります。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)