Partager via


Fonction SHLoadLibraryFromParsingName (shobjidl_core.h)

Crée et charge un objet IShellLibrary pour un chemin d’accès spécifié.

Syntaxe

HRESULT SHLoadLibraryFromParsingName(
  [in]  PCWSTR pszParsingName,
  [in]  DWORD  grfMode,
  [in]  REFIID riid,
  [out] void   **ppv
);

Paramètres

[in] pszParsingName

Type : PCWSTR

Chemin d’accès pour lequel charger l’objet IShellLibrary .

[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

Référence à l’IID de l’interface à récupérer via ppv, généralement IID_IShellLibrary.

[out] ppv

Type : void**

Lorsque cette méthode retourne correctement, contient le pointeur d’interface demandé dans riid. Il s’agit généralement de IShellLibrary.

Valeur retournée

Type : HRESULT

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

Remarques

Nous vous recommandons d’utiliser la macro IID_PPV_ARGS , définie dans Objbase.h, pour empaqueter les paramètres riid et ppv . Cette macro fournit l’IID correct en fonction de l’interface pointée par la valeur dans ppv, ce qui élimine la possibilité d’une erreur de codage dans riid qui pourrait entraîner des résultats inattendus.

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

Configuration requise

   
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)

Voir aussi

IShellLibrary

IShellLibrary::LoadLibraryFromItem

IShellLibrary::LoadLibraryFromKnownFolder

SHCreateLibrary

SHLoadLibraryFromItem

SHLoadLibraryFromKnownFolder