SHLoadLibraryFromParsingName 函式 (shobjidl_core.h)

建立並載入指定路徑的 IShellLibrary 物件。

語法

HRESULT SHLoadLibraryFromParsingName(
  [in]  PCWSTR pszParsingName,
  [in]  DWORD  grfMode,
  [in]  REFIID riid,
  [out] void   **ppv
);

[in] pszParsingName

類型： PCWSTR

要載入 IShellLibrary 物件的路徑。

[in] grfMode

類型： DWORD

一或多個儲存媒體旗標，指定程式庫物件的存取和共用模式。常用的旗標 是STGM_READ 或 STGM_READWRITE。如需詳細資訊，請參閱 STGM。

[in] riid

類型： REFIID

要透過 ppv擷取之介面 IID 的參考，通常IID_IShellLibrary。

[out] ppv

類型： void**

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

類型： HRESULT

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

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

這是內嵌協助程式函式，可包裝 IShellLibrary：：LoadLibraryFromItem 方法。