Fonction SHLoadLibraryFromItem (shobjidl_core.h)

Article
03/04/2024

Crée et charge un objet IShellLibrary à partir d’un fichier de définition de bibliothèque spécifié.

Syntaxe

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

Paramètres

[in] psiLibrary

Type : IShellItem*

Objet IShellItem pour le fichier de définition de bibliothèque à charger.

[in] grfMode

Type : DWORD

Un ou plusieurs indicateurs de support de stockage qui spécifient les modes d’accès et de partage pour l’objet de bibliothèque. Les indicateurs couramment spécifiés sont STGM_READ ou STGM_READWRITE. Pour plus d’informations, consultez STGM.

[in] riid

Type : REFIID

IID pour IShellLibrary. (Voir les remarques sur l’utilisation.)

[out] ppv

Type : void**

Reçoit l’objet IShellLibrary chargé. (Voir les remarques sur l’utilisation.)

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Utilisation

La macro IID_PPV_ARGS est généralement utilisée pour générer les paramètres riid et ppv pour cette fonction. Pour obtenir un exemple, consultez SHCreateLibrary.

Il s’agit d’une fonction d’assistance inline qui encapsule la méthode IShellLibrary ::LoadLibraryFromItem .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)