Funzione SHLoadLibraryFromParsingName (shobjidl_core.h)

Articolo
08/26/2023

Crea e carica un oggetto IShellLibrary per un percorso specificato.

Sintassi

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

Parametri

[in] pszParsingName

Tipo: PCWSTR

Percorso per il quale caricare l'oggetto IShellLibrary .

[in] grfMode

Tipo: DWORD

Uno o più flag di supporto di archiviazione che specificano le modalità di accesso e condivisione per l'oggetto libreria. I flag comunemente specificati sono STGM_READ o STGM_READWRITE. Per altre informazioni, vedere STGM.

[in] riid

Tipo: REFIID

Riferimento all'IID dell'interfaccia da recuperare tramite ppv, in genere IID_IShellLibrary.

[out] ppv

Tipo: void**

Quando questo metodo viene restituito correttamente, contiene il puntatore di interfaccia richiesto in riid. Si tratta in genere di IShellLibrary.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

È consigliabile usare la macro IID_PPV_ARGS , definita in Objbase.h, per creare un pacchetto dei parametri riid e ppv . Questa macro fornisce l'IID corretto in base all'interfaccia a cui punta il valore in ppv, che elimina la possibilità di un errore di codifica in riid che potrebbe causare risultati imprevisti.

Si tratta di una funzione helper inline che esegue il wrapping del metodo IShellLibrary::LoadLibraryFromItem .

Requisiti


Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)