Partager via


Fonction SHLoadLibraryFromKnownFolder (shobjidl_core.h)

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)

Voir aussi

IShellLibrary

IShellLibrary ::LoadLibraryFromItem

IShellLibrary ::LoadLibraryFromKnownFolder

Dossiers connus, exemple

SHCreateLibrary

SHLoadLibraryFromItem

SHLoadLibraryFromParsingName