IShellExtInit::Initialize メソッド (shobjidl_core.h)

プロパティ シート拡張機能、ショートカット メニュー拡張機能、またはドラッグ アンド ドロップ ハンドラーを初期化します。

構文

HRESULT Initialize(
  [in] PCIDLIST_ABSOLUTE pidlFolder,
  [in] IDataObject       *pdtobj,
  [in] HKEY              hkeyProgID
);

パラメーター

[in] pidlFolder

種類: PCIDLIST_ABSOLUTE

フォルダーを一意に識別する ITEMIDLIST 構造体へのポインター。 プロパティ シートの拡張子の場合、このパラメーターは NULL です。 ショートカット メニュー拡張機能の場合、ショートカット メニューが表示されているアイテムを含むフォルダーのアイテム識別子リストです。 既定以外のドラッグ アンド ドロップ メニュー拡張機能の場合、このパラメーターはターゲット フォルダーを指定します。

[in] pdtobj

型: IDataObject*

処理対象のオブジェクトを取得するために使用できる IDataObject インターフェイス オブジェクトへのポインター。

[in] hkeyProgID

種類: HKEY

ファイル オブジェクトまたはフォルダーの種類のレジストリ キー。

戻り値

種類: HRESULT

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

解説

一部のパラメーターの意味は、拡張の種類によって異なります。 ドラッグ アンド ドロップ ハンドラーの場合、 pidlFolder パラメーターは移動先フォルダー (ドロップ 先) を指定し、 pdtobj パラメーターはドロップするアイテムを識別し、 hkeyProgID パラメーターは移動先フォルダーのファイルの種類を指定します。

ショートカット メニュー拡張機能の場合、pdtobj は選択したファイル オブジェクトを識別し、hkeyProgID はフォーカスのあるオブジェクトのファイルの種類を識別し、pidlFolder は NULL (ファイル オブジェクトの場合) であるか、ショートカット メニューが要求されているフォルダー (フォルダーの背景ショートカット メニューの場合) を指定します。

プロパティ シート拡張子の 場合、pidlFolder は NULL、 pdtobj は選択したファイル オブジェクトを識別し、 hkeyProgID はフォーカスを持つファイル オブジェクトのファイルの種類を指定します。

実装者へのメモ

これは、シェルがプロパティ シート拡張機能、ショートカット メニュー拡張機能、またはドラッグ アンド ドロップ ハンドラーのインスタンスを作成した後に呼び出す最初のメソッドです。

要件

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