IShellLibrary：：LoadLibraryFromKnownFolder 方法 (shobjidl_core.h)

發行項
03/02/2024

載入 KNOWNFOLDERID 所參考的連結庫。

語法

HRESULT LoadLibraryFromKnownFolder(
  [in] REFKNOWNFOLDERID kfidLibrary,
  [in] DWORD            grfMode
);

參數

[in] kfidLibrary

類型： REFKNOWNFOLDERID

KNOWNFOLDERID 值，可識別要載入的連結庫。

[in] grfMode

類型： DWORD

一或多個 STGM 儲存媒體旗標，指定連結庫物件的存取和共用模式。

傳回值

類型： HRESULT

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

備註

如果呼叫此方法時 IShellLibrary 物件包含連結庫，該連結庫會在記憶體中以新的連結庫覆寫。

如果此連結庫沒有現有的 IShellLibrary 物件，則可以呼叫 SHLoadLibraryFromItem 來取代此方法。

範例

下列程式代碼範例顯示協助程式函式 SHLoadLibraryFromKnownFolder，它會包裝此方法。

//
// from shobjidl.h
//
__inline HRESULT SHLoadLibraryFromKnownFolder(
    __in REFKNOWNFOLDERID kfidLibrary, 
    __in DWORD grfMode, 
    __in REFIID riid, 
    __deref_out void **ppv)
{
    *ppv = NULL;
    IShellLibrary *plib;
    HRESULT hr = CoCreateInstance( 
        CLSID_ShellLibrary,
        NULL,
        CLSCTX_INPROC_SERVER,
        IID_PPV_ARGS(&plib));
    if (SUCCEEDED(hr))
    {
        hr = plib->LoadLibraryFromKnownFolder(kfidLibrary, grfMode);
        if (SUCCEEDED(hr))
        {
            hr = plib->QueryInterface(riid, ppv);
        }
        plib->Release();
    }
    return hr;}

規格需求

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