IShellIconOverlayIdentifier::GetPriority メソッド (shobjidl_core.h)
アイコン オーバーレイの優先度を指定します。
構文
HRESULT GetPriority(
[out] int *pPriority
);
パラメーター
[out] pPriority
型: int*
オーバーレイ識別子の優先度を示す値のアドレス。 指定できる値の範囲は 0 から 100 で、優先度は 0 です。
戻り値
型: HRESULT
成功した場合はS_OKを返し、それ以外の場合は COM エラー コードを返します。
解説
1 つのオブジェクトに対して複数のアイコン オーバーレイを使用できる場合は、優先度が最も高いものが選択されます。 シェルには、多くの場合の優先順位を決定する一連の内部規則があります。 GetPriority によって返される値は、シェルの内部規則が適用されない場合に使用されます。 通常は、値を 0 に設定する必要があります。 ただし、優先度の値は、同じオブジェクトのアイコン オーバーレイ アイコンを要求できる 2 つ以上のアイコン オーバーレイ ハンドラーを実装している場合に便利です。 優先度の値を適切に設定することで、要求されたアイコン オーバーレイのどれを表示するかを指定できます。
要件
| サポートされている最小のクライアント | Windows 2000 Professional、Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | shobjidl_core.h (Shlobj.h を含む) |
| [DLL] | Shell32.dll (バージョン 5.0 以降) |