Metode IShellLibrary::LoadLibraryFromKnownFolder (shobjidl_core.h)

Artikel
03/02/2024

Memuat pustaka yang dirujuk oleh KNOWNFOLDERID.

Sintaks

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

Parameter

[in] kfidLibrary

Jenis: REFKNOWNFOLDERID

Nilai KNOWNFOLDERID yang mengidentifikasi pustaka yang akan dimuat.

[in] grfMode

Jenis: DWORD

Satu atau beberapa bendera media penyimpanan STGM yang menentukan mode akses dan berbagi untuk objek pustaka.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Jika objek IShellLibrary berisi pustaka saat metode ini dipanggil, pustaka tersebut ditimpa dalam memori dengan pustaka baru.

Jika tidak ada objek IShellLibrary yang ada untuk pustaka ini, SHLoadLibraryFromItem dapat dipanggil sebagai pengganti metode ini.

Contoh

Contoh kode berikut menunjukkan fungsi pembantu SHLoadLibraryFromKnownFolder, yang membungkus metode ini.

//
// 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;}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)