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 () ,或指定資料夾背景快捷方式功能表要求的資料夾 () 。

對於屬性工作表延伸模組, pidlFolderNullpdtobj 會識別選取的檔案物件, 而 hkeyProgID 會指定具有焦點之檔案物件的檔案類型。

實作者的注意事項

這是 Shell 在建立屬性工作表延伸模組、快捷方式功能表延伸模組或拖放處理常式實例之後所呼叫的第一個方法。

規格需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包括 Shobjidl.h)
Dll Shell32.dll (4.0 版或更新版本)