Fonction SHLoadLibraryFromParsingName (shobjidl_core.h)

Article
08/26/2023

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)