SHLoadLibraryFromItem-Funktion (shobjidl_core.h)

Artikel
03/04/2024

Erstellt und lädt ein IShellLibrary-Objekt aus einer angegebenen Bibliotheksdefinitionsdatei.

Syntax

HRESULT SHLoadLibraryFromItem(
  [in]  IShellItem *psiLibrary,
  [in]  DWORD      grfMode,
  [in]  REFIID     riid,
  [out] void       **ppv
);

Parameter

[in] psiLibrary

Typ: IShellItem*

Ein IShellItem-Objekt für die zu ladende Bibliotheksdefinitionsdatei.

[in] grfMode

Art: DWORD

Mindestens ein Speichermedium-Flag, das Zugriffs- und Freigabemodi für das Bibliotheksobjekt angibt. Häufig angegebene Flags sind STGM_READ oder STGM_READWRITE. Weitere Informationen finden Sie unter STGM.

[in] riid

Typ: REFIID

Die IID für IShellLibrary. (Siehe Hinweise zur Verwendung.)

[out] ppv

Typ: void**

Empfängt das geladene IShellLibrary-Objekt . (Siehe Hinweise zur Verwendung.)

Rückgabewert

Typ: HRESULT

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

Hinweise

Verwendungszweck

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

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

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 (einschließlich Shobjidl.h)