IPersistFolder3::InitializeEx メソッド (shobjidl_core.h)

フォルダーを初期化し、名前空間内の場所を指定します。 フォルダーがショートカットの場合、このメソッドはターゲット フォルダーの場所も指定します。

構文

HRESULT InitializeEx(
  [in] IBindCtx                         *pbc,
  [in] PCIDLIST_ABSOLUTE                pidlRoot,
  [in] const PERSIST_FOLDER_TARGET_INFO *ppfti
);

パラメーター

[in] pbc

種類: IBindCtx*

バインド コンテキストを提供する IBindCtx オブジェクトへのポインター。 このパラメーターは、NULL でもかまいません。

[in] pidlRoot

型: LPCITEMIDLIST

フォルダーまたはフォルダー ショートカットの絶対位置を指定する完全修飾 PIDL へのポインター。 呼び出し元のアプリケーションは、この PIDL の割り当てと解放を担当します。

[in] ppfti

型: const PERSIST_FOLDER_TARGET_INFO*

ターゲット フォルダーとその属性の場所を指定する PERSIST_FOLDER_TARGET_INFO 構造体へのポインター。

ppfti が有効な構造体を指している場合、pidlRoot はフォルダー ショートカットを表します。

ppfti が NULL に設定されている場合、pidlRoot は通常のフォルダーを表します。 その場合、 InitializeEx は Initialize が呼び出されたかのように動作する必要があります。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

この関数は、 IPersistFolder::Initialize の拡張バージョンです。 これにより、シェルは通常のフォルダーと同様にフォルダー ショートカットを初期化できます。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional with SP3, Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)
[DLL]	Shell32.dll (バージョン 5.0 以降)