SHARD 列挙 (shlobj_core.h)

  • [アーティクル]

使用統計が追跡されている項目を識別するために、PV パラメーターで SHAddToRecentDocs によって渡されるデータの解釈を示します。

構文

typedef enum {
  SHARD_PIDL,
  SHARD_PATHA,
  SHARD_PATHW,
  SHARD_APPIDINFO,
  SHARD_APPIDINFOIDLIST,
  SHARD_LINK,
  SHARD_APPIDINFOLINK,
  SHARD_SHELLITEM
} SHARD;

定数

 
SHARD_PIDL
pv パラメーターは、ドキュメントのファイル オブジェクトを識別する PIDL を指します。 ファイル以外のオブジェクトを識別する PIDL は受け入れられません。
SHARD_PATHA
pv パラメーターは、オブジェクトのパスとファイル名を持つ null で終わる ANSI 文字列を指します。
SHARD_PATHW
pv パラメーターは、オブジェクトのパスとファイル名を持つ null で終わる Unicode 文字列を指します。
SHARD_APPIDINFO
Windows 7 以降。 pv パラメーターは、アイテムを特定のプロセスまたはアプリケーションに関連付ける AppUserModelID と識別する IShellItem をペアにする SHARDAPPIDINFO 構造体を指します。
SHARD_APPIDINFOIDLIST
Windows 7 以降。 pv パラメーターは、項目を特定のプロセスまたはアプリケーションに関連付ける AppUserModelID と識別する絶対 PIDL をペアにする SHARDAPPIDINFOIDLIST 構造体を指します。
SHARD_LINK
Windows 7 以降。 pv パラメーターは、IShellLink オブジェクトへのインターフェイス ポインターです。
SHARD_APPIDINFOLINK
Windows 7 以降。 pv パラメーターは、アイテムを特定のプロセスまたはアプリケーションに関連付ける AppUserModelID と識別する IShellLink をペアにする SHARDAPPIDINFOLINK 構造体を指します。
SHARD_SHELLITEM
Windows 7 以降。 pv パラメーターは、IShellItem オブジェクトへのインターフェイス ポインターです。

解説

Windows 7 より前は、SHARD_PIDL、SHARD_PATHA、およびSHARD_PATHWは列挙メンバーとしてではなく、個々の定数として定義されていました。

SHARD_LINKまたはSHARD_APPIDINFOLINKを介して IShellLink を提供する場合、IShellLink インスタンスは次を提供する必要があります。

表示名は、アイテムの System.Title (PKEY_Title) プロパティを使用して設定する必要があります。 プロパティは、表示名を直接保持することも、"@shell32.dll,-1324" などの間接的な文字列表現を使用して格納された文字列を使用することもできます。 間接文字列を使用すると、ユーザーが選択した言語でアイテム名を表示できます。

必要に応じて、説明フィールド (IShellLink::SetDescription) を設定して、ジャンプ リスト内のアイテムのカスタム ヒントを提供できます。

要件

   
サポートされている最小のクライアント Windows 2000 Professional、Windows XP、Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header shlobj_core.h (Shlobj.h を含む)

関連項目

SHAddToRecentDocs