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_IShellItem 或 IID_IShellItem2。

[out] ppv

類型： void**

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

傳回值

類型： HRESULT

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

備註

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

需求

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