共用方式為


SHCreateItemFromParsingName 函式 (shobjidl_core.h)

從剖析名稱建立並初始化殼層項目物件。

語法

SHSTDAPI SHCreateItemFromParsingName(
  [in]           PCWSTR   pszPath,
  [in, optional] IBindCtx *pbc,
  [in]           REFIID   riid,
  [out]          void     **ppv
);

參數

[in] pszPath

類型: PCWSTR

顯示名稱的指標。

[in, optional] pbc

類型: IBindCtx*

選擇性。 系結內容的指標,用來將參數當做輸入和輸出傳遞至剖析函式。 這些傳遞的參數通常專屬於資料來源,並由資料來源擁有者記載。 例如,檔案系統資料來源會使用STR_FILE_SYS_BIND_DATA系結內容參數,接受 (剖析為WIN32_FIND_DATA結構) 的名稱。

STR_PARSE_PREFER_FOLDER_BROWSING 可以傳遞,以指出 URL 會在可能的情況下使用檔案系統資料來源進行剖析。 使用 CreateBindCtx 建構系結內容物件,並使用 IBindCtx::RegisterObjectParam填入值。 如需這些完整清單,請參閱 系結內容字串金鑰 。 如需使用此參數的範例,請參閱剖析 與參數範例

如果未將資料傳遞至剖析函式或從剖析函式接收資料,這個值可以是 Null

[in] riid

類型: REFIID

要透過 ppv擷取之介面 IID 的參考,通常 IID_IShellItemIID_IShellItem2

[out] ppv

類型: void**

當這個方法成功傳回時,包含 riid中要求的介面指標。 這通常是 IShellItemIShellItem2

傳回值

類型: HRESULT

如果此函式成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

建議您使用在 Objbase.h 中定義的 IID_PPV_ARGS 宏來封裝 riidppv 參數。 此宏會根據ppv中值所指向的介面提供正確的IID,這可消除riid中可能導致非預期結果的編碼錯誤的可能性。

需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包括 Shobjidl.h)
Dll Shell32.dll