SHLoadLibraryFromKnownFolder 函式 (shobjidl_core.h)

發行項
03/02/2024

為指定的已知資料夾標識碼建立並載入 IShellLibrary 物件。

語法

HRESULT SHLoadLibraryFromKnownFolder(
  [in]  REFKNOWNFOLDERID kfidLibrary,
  [in]  DWORD            grfMode,
  [in]  REFIID           riid,
  [out] void             **ppv
);

參數

[in] kfidLibrary

類型： REFKNOWNFOLDERID

KNOWNFOLDERID 值，可識別要載入 IShellLibrary 物件的已知資料夾。

[in] grfMode

類型： DWORD

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

[in] riid

類型： REFIID

IShellLibrary 的 IID。 (如需詳細資訊，請參閱。)

[out] ppv

類型： void**

當此函式成功傳回時，會接收載入的 IShellLibrary 物件。 (如需詳細資訊，請參閱。)

傳回值

類型： HRESULT

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

備註

這是包裝 IShellLibrary：：LoadLibraryFromKnownFolder 方法的內嵌協助程序函式。

使用

IID_PPV_ARGS宏通常用於產生此函式的 riid 和 ppv 參數。如需範例，請參閱 SHCreateLibrary。

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限桌面應用程式]
目標平台	Windows
標頭	shobjidl_core.h (包含 Shobjidl.h)