Funzione SHLoadLibraryFromKnownFolder (shobjidl_core.h)

Articolo
03/02/2024

Crea e carica un oggetto IShellLibrary per un ID di cartella noto specificato.

Sintassi

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

Parametri

[in] kfidLibrary

Tipo: REFKNOWNFOLDERID

Valore KNOWNFOLDERID che identifica la cartella nota da caricare nell'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

IID per IShellLibrary. Per altre informazioni, vedere Osservazioni.

[out] ppv

Tipo: void**

Quando questa funzione restituisce correttamente, riceve l'oggetto IShellLibrary caricato. Per altre informazioni, vedere Osservazioni.

Valore restituito

Tipo: HRESULT

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

Commenti

Questa è una funzione helper inline che esegue il wrapping del metodo IShellLibrary::LoadLibraryFromKnownFolder .

Utilizzo

La macro IID_PPV_ARGS viene in genere usata per generare i parametri riid e ppv per questa funzione. Per un esempio, vedere SHCreateLibrary.

Requisiti

Requisito	Valore
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)