SHLoadLibraryFromKnownFolder-Funktion (shobjidl_core.h)

Artikel
03/02/2024

Erstellt und lädt ein IShellLibrary-Objekt für eine angegebene bekannte Ordner-ID.

Syntax

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

Parameter

[in] kfidLibrary

Typ: REFKNOWNFOLDERID

Der KNOWNFOLDERID-Wert , der den bekannten Ordner angibt, der in das IShellLibrary-Objekt geladen werden soll.

[in] grfMode

Art: DWORD

Ein oder mehrere Speichermediumflags, die Zugriffs- und Freigabemodi für das Bibliotheksobjekt angeben. Häufig angegebene Flags werden STGM_READ oder STGM_READWRITE. Weitere Informationen finden Sie unter STGM.

[in] riid

Typ: REFIID

Die IID für IShellLibrary. (Weitere Informationen finden Sie unter Hinweise.)

[out] ppv

Typ: void**

Wenn diese Funktion erfolgreich zurückgegeben wird, empfängt das geladene IShellLibrary-Objekt . (Weitere Informationen finden Sie unter Hinweise.)

Rückgabewert

Typ: HRESULT

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

Hinweise

Dies ist eine Inlinehilfsfunktion, die die IShellLibrary::LoadLibraryFromKnownFolder-Methode umschließt.

Verwendungszweck

Das IID_PPV_ARGS Makro wird im Allgemeinen verwendet, um die Riid - und ppv-Parameter für diese Funktion zu generieren. Ein Beispiel finden Sie unter SHCreateLibrary.

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)