IShellLibrary::LoadLibraryFromKnownFolder-Methode (shobjidl_core.h)

Artikel
03/02/2024

Lädt die Bibliothek, auf die durch eine KNOWNFOLDERID verwiesen wird.

Syntax

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

Parameter

[in] kfidLibrary

Typ: REFKNOWNFOLDERID

Der KNOWNFOLDERID-Wert , der die zu ladende Bibliothek identifiziert.

[in] grfMode

Art: DWORD

Mindestens ein STGM-Speichermediumflags , das Zugriffs- und Freigabemodi für das Bibliotheksobjekt angibt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn das IShellLibrary-Objekt beim Aufrufen dieser Methode eine Bibliothek enthält, wird diese Bibliothek im Arbeitsspeicher mit der neuen Bibliothek überschrieben.

Wenn kein IShellLibrary-Objekt für diese Bibliothek vorhanden ist, kann SHLoadLibraryFromItem anstelle dieser Methode aufgerufen werden.

Beispiele

Das folgende Codebeispiel zeigt die Hilfsfunktion SHLoadLibraryFromKnownFolder, die diese Methode umschließt.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)