PERSIST_FOLDER_TARGET_INFO 構造体 (shobjidl_core.h)

  • [アーティクル]

フォルダー ショートカットのターゲット フォルダーとその属性を指定します。 この構造体は、 IPersistFolder3::GetFolderTargetInfo および IPersistFolder3::InitializeEx によって使用されます。

構文

typedef struct _PERSIST_FOLDER_TARGET_INFO {
  PIDLIST_ABSOLUTE pidlTargetFolder;
  WCHAR            szTargetParsingName[260];
  WCHAR            szNetworkProvider[260];
  DWORD            dwAttributes;
  int              csidl;
} PERSIST_FOLDER_TARGET_INFO;

メンバー

pidlTargetFolder

種類: PIDLIST_ABSOLUTE

ターゲット フォルダーの完全修飾 PIDL。 指定しない場合 は、pidlTargetFolderを NULL に設定します。

szTargetParsingName[260]

種類: WCHAR[MAX_PATH]

ターゲット フォルダーの解析名を持つ null で終わる Unicode 文字列。 指定しない場合 は、szTargetParsingName を空の文字列に設定します。

szNetworkProvider[260]

種類: WCHAR[MAX_PATH]

ターゲット フォルダーへのバインド時に使用されるネットワーク プロバイダーの種類を指定する、null で終わる Unicode 文字列。 形式は、 WNet API で使用される形式と同じです。 指定しない場合は 、szNetworkProvider を空の文字列に設定します。

dwAttributes

型: DWORD

Winnt.h で定義されているFILE_ATTRIBUTE_* フラグを含む DWORD 値。 指定しない場合 は、dwAttributes を -1 に設定します。

csidl

型: int

ターゲット フォルダーの CSIDL 値 (存在する場合)。 ターゲット フォルダーに CSIDL がない場合は、 csidl を -1 に設定します。 CSIDL 値に加えて、次の 2 つのフラグを設定することもできます。

CSIDL_FLAG_PFTI_TRACKTARGET

ユーザーがターゲット フォルダーの基になる CSIDL 値を変更した場合に、ターゲット フォルダーを変更する必要があることを示します。

CSIDL_FLAG_CREATE

ターゲット フォルダーがまだ存在しない場合は作成する必要があることを示します。

注釈

pidlTargetFolder、szTargetParsingName、および csidl メンバーのいずれかまたはすべてを使用して、ターゲット フォルダーの場所を指定できます。

要件

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

こちらもご覧ください

IPersistFolder3