Fonction SHLoadLibraryFromKnownFolder (shobjidl_core.h)

Article
03/02/2024

Crée et charge un objet IShellLibrary pour un ID de dossier connu spécifié.

Syntaxe

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

Paramètres

[in] kfidLibrary

Type : REFKNOWNFOLDERID

Valeur KNOWNFOLDERID qui identifie le dossier connu à charger dans l’objet IShellLibrary .

[in] grfMode

Type : DWORD

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

[in] riid

Type : REFIID

IID pour IShellLibrary. (Voir Remarques pour plus d’informations.)

[out] ppv

Type : void**

Lorsque cette fonction retourne correctement, reçoit l’objet IShellLibrary chargé. (Voir Remarques pour plus d’informations.)

Valeur retournée

Type : HRESULT

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

Remarques

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

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.

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 (inclure Shobjidl.h)